Amazon Gamelift

Overview

Amazon GameLift is a fully managed service for deploying, operating, and scaling your session-based multiplayer game servers in the cloud.

Enable this integration to see all your Gamelift metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that Game Lift is enabled under the Metric Collection tab.
  2. Install the Datadog - Amazon Gamelift integration.

Log collection

Enable logging

Configure Amazon GameLift to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_gamelift is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon GameLift logs in the AWS console:

Data Collected

Metrics

aws.gamelift.activating_game_sessions
(count)
The average number of game sessions with status activating .
aws.gamelift.activating_game_sessions.maximum
(count)
The maximum number of game sessions with status activating .
aws.gamelift.activating_game_sessions.minimum
(count)
The minimum number of game sessions with status activating .
aws.gamelift.active_game_sessions
(count)
The average number of game sessions with status active .
aws.gamelift.active_game_sessions.maximum
(count)
The maximum number of game sessions with status active .
aws.gamelift.active_game_sessions.minimum
(count)
The minimum number of game sessions with status active .
aws.gamelift.active_instances
(count)
The average number of instances with active status.
aws.gamelift.active_instances.maximum
(count)
The maximum number of instances with active status.
aws.gamelift.active_instances.minimum
(count)
The minimum number of instances with active status.
aws.gamelift.active_server_processes
(count)
The average number server processes with status active.
aws.gamelift.active_server_processes.maximum
(count)
The maximum number of server processes with status active.
aws.gamelift.active_server_processes.minimum
(count)
The minimum number of server processes with status active.
aws.gamelift.available_game_servers
(count)
Game servers that are available to run a game execution and are not currently occupied with gameplay.
aws.gamelift.available_game_sessions
(count)
The average number of game session slots on active & healthy processes not being used.
aws.gamelift.available_game_sessions.maximum
(count)
The maximum number of game session slots on active & healthy processes not being used.
aws.gamelift.available_game_sessions.minimum
(count)
The minimum number of game session slots on active & healthy processes not being used.
aws.gamelift.average_wait_time
(count)
The average amount of time a game session requests in the que with status pending have been waiting.
aws.gamelift.average_wait_time.maximum
(count)
The maximum amount of time a game session requests in the que with status pending have been waiting.
aws.gamelift.average_wait_time.minimum
(count)
The minimum amount of time a game session requests in the que with status pending have been waiting.
aws.gamelift.average_wait_time.sum
(count)
The sum of the amount of time a game session requests in the que with status pending have been waiting.
aws.gamelift.current_player_sessions
(count)
The average number of player sessions with active or reserved status.
aws.gamelift.current_player_sessions.maximum
(count)
The maximum number of player sessions with active or reserved status.
aws.gamelift.current_player_sessions.minimum
(count)
The minimum number of player sessions with active or reserved status.
aws.gamelift.current_tickets
(count)
Matchmaking requests currently being processed or waiting to be processed.
aws.gamelift.desired_instances
(count)
The average number of active instances working to maintain the fleet.
aws.gamelift.desired_instances.maximum
(count)
The maximum number of active instances working to maintain the fleet.
aws.gamelift.desired_instances.minimum
(count)
The minimum number of active instances working to maintain the fleet.
aws.gamelift.draining_available_game_servers
(count)
Game servers on instances scheduled for termination that are currently not supporting gameplay.
aws.gamelift.draining_utilized_game_servers
(count)
Game servers on instances scheduled for termination that are currently supporting gameplay.
aws.gamelift.first_choice_not_viable
(count)
The average number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable.
aws.gamelift.first_choice_not_viable.maximum
(count)
The maximum number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable.
aws.gamelift.first_choice_not_viable.minimum
(count)
The minimum number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable.
aws.gamelift.first_choice_not_viable.sum
(count)
The sum of the number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable.
aws.gamelift.first_choice_out_of_capacity
(count)
The average number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources.
aws.gamelift.first_choice_out_of_capacity.maximum
(count)
The maximum number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources.
aws.gamelift.first_choice_out_of_capacity.minimum
(count)
The minimum number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources.
aws.gamelift.first_choice_out_of_capacity.sum
(count)
The sum of the number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources.
aws.gamelift.game_server_interruptions
(count)
Game servers on Spot Instances that were interrupted due to limited Spot availability.
aws.gamelift.game_session_interruptions
(count)
The average number of game session that have been interrupted.
aws.gamelift.game_session_interruptions.maximum
(count)
The maximum number of game session that have been interrupted.
aws.gamelift.game_session_interruptions.minimum
(count)
The minimum number of game session that have been interrupted.
aws.gamelift.game_session_interruptions.sum
(count)
The sum of the number of game session that have been interrupted.
aws.gamelift.healthy_server_processes
(count)
The average number of server processes that are reporting healthy.
aws.gamelift.healthy_server_processes.maximum
(count)
The maximum number of server processes that are reporting healthy.
aws.gamelift.healthy_server_processes.minimum
(count)
The minimum number of server processes that are reporting healthy.
aws.gamelift.idle_instances
(count)
The average number of active instances hosting 0 game sessions.
aws.gamelift.idle_instances.maximum
(count)
The maximum number of active instances hosting 0 game sessions.
aws.gamelift.idle_instances.minimum
(count)
The minimum number of active instances hosting 0 game sessions.
aws.gamelift.instance_interruptions
(count)
The average number of spot instances that have been interrupted.
aws.gamelift.instance_interruptions.maximum
(count)
The maximum number of spot instances that have been interrupted.
aws.gamelift.instance_interruptions.minimum
(count)
The minimum number of spot instances that have been interrupted.
aws.gamelift.instance_interruptions.sum
(count)
The sum of the number of spot instances that have been interrupted.
aws.gamelift.lowest_latency_placement
(count)
The average number of game sessions placed in a region that offers the queue's lowest possible latency.
aws.gamelift.lowest_latency_placement.maximum
(count)
The maximum number of game sessions placed in a region that offers the queue's lowest possible latency.
aws.gamelift.lowest_latency_placement.minimum
(count)
The minimum number of game sessions placed in a region that offers the queue's lowest possible latency.
aws.gamelift.lowest_latency_placement.sum
(count)
The sum of the number of game sessions placed in a region that offers the queue's lowest possible latency.
aws.gamelift.lowest_price_placement
(count)
The average number of game sessions placed in a region that offers the queue's lowest price for the region.
aws.gamelift.lowest_price_placement.maximum
(count)
The maximum number of game sessions placed in a region that offers the queue's lowest price for the region.
aws.gamelift.lowest_price_placement.minimum
(count)
The minimum number of game sessions placed in a region that offers the queue's lowest price for the region.
aws.gamelift.lowest_price_placement.sum
(count)
The sum of the number of game sessions placed in a region that offers the queue's lowest price for the region.
aws.gamelift.matches_accepted
(count)
Matches that were successfully accepted by all players since the last report.
aws.gamelift.matches_created
(count)
Potential matches that were created since the last report.
aws.gamelift.matches_placed
(count)
Matches that were successfully placed into a game session since the last report.
aws.gamelift.matches_rejected
(count)
For matchmaking configurations that require acceptance, the potential matches that were rejected by at least one player since the last report.
aws.gamelift.max_instances
(count)
The average of the maximum number of instances allowed for the fleet.
aws.gamelift.max_instances.maximum
(count)
The total maximum number of instances allowed for the fleet.
aws.gamelift.max_instances.minimum
(count)
The minimum of maximum number of instances allowed for the fleet.
aws.gamelift.min_instances
(count)
The average of the minimum number of instances allowed for the fleet.
aws.gamelift.min_instances.maximum
(count)
The maximum of minimum number of instances allowed for the fleet.
aws.gamelift.min_instances.minimum
(count)
The absolute minimum number of instances allowed for the fleet.
aws.gamelift.minimum_instances
(count)
The average of the minimum number of instances allowed for the fleet.
aws.gamelift.minimum_instances.maximum
(count)
The maximum of minimum number of instances allowed for the fleet.
aws.gamelift.minimum_instances.minimum
(count)
The absolute minimum number of instances allowed for the fleet.
aws.gamelift.percent_available_game_sessions
(count)
The average number of game session slots on all active server processes that are not being used.
Shown as percent
aws.gamelift.percent_healthy_server_processes
(count)
The average percent of server processes that are reporting healthy.
Shown as percent
aws.gamelift.percent_healthy_server_processes.maximum
(count)
The maximum percent of server processes that are reporting healthy.
Shown as percent
aws.gamelift.percent_healthy_server_processes.minimum
(count)
The minimum percent of server processes that are reporting healthy.
Shown as percent
aws.gamelift.percent_idle_instances
(count)
The average percentage of active instances that are idle.
aws.gamelift.percent_idle_instances.maximum
(count)
The maximum percentage of active instances that are idle.
aws.gamelift.percent_idle_instances.minimum
(count)
The minimum percentage of active instances that are idle.
aws.gamelift.percent_utilized_game_servers
(count)
Portion of game servers that are currently supporting game executions.
Shown as percent
aws.gamelift.placements_cancelled
(count)
The average number of game session placement requests that were cancelled.
aws.gamelift.placements_cancelled.maximum
(count)
The maximum number of game session placement requests that were cancelled.
aws.gamelift.placements_cancelled.minimum
(count)
The minimum number of game session placement requests that were cancelled.
aws.gamelift.placements_cancelled.sum
(count)
The sum of the number of game session placement requests that were cancelled.
aws.gamelift.placements_failed
(count)
The average number of game session placement requests tha failed.
aws.gamelift.placements_started
(count)
The average number of game session placement requests that were added to the queue.
aws.gamelift.placements_started.maximum
(count)
The maximum number of game session placement requests that were added to the queue.
aws.gamelift.placements_started.minimum
(count)
The minimum number of game session placement requests that were added to the queue.
aws.gamelift.placements_started.sum
(count)
The sum of the number of game session placement requests that were added to the queue.
aws.gamelift.placements_succeeded
(count)
The average number of game session placement requests that resulted in a new session.
aws.gamelift.placements_succeeded.maximum
(count)
The maximum number of game session placement requests that resulted in a new session.
aws.gamelift.placements_succeeded.minimum
(count)
The minimum number of game session placement requests that resulted in a new session.
aws.gamelift.placements_succeeded.sum
(count)
The sum of the number of game session placement requests that resulted in a new session.
aws.gamelift.placements_timed_out
(count)
The average number of game session placement requests that reached the queue's timeout limit.
aws.gamelift.placements_timed_out.maximum
(count)
The maximum number of game session placement requests that reached the queue's timeout limit.
aws.gamelift.placements_timed_out.minimum
(count)
The minimum number of game session placement requests that reached the queue's timeout limit.
aws.gamelift.placements_timed_out.sum
(count)
The sum of the number of game session placement requests that reached the queue's timeout limit.
aws.gamelift.player_session_activations
(count)
The average number of player sessions that transitioned from reserved to active.
aws.gamelift.player_session_activations.maximum
(count)
The maximum number of player sessions that transitioned from reserved to active.
aws.gamelift.player_session_activations.minimum
(count)
The minimum number of player sessions that transitioned from reserved to active.
aws.gamelift.player_session_activations.sum
(count)
The sum of the number of player sessions that transitioned from reserved to active.
aws.gamelift.players_started
(count)
Players in matchmaking tickets that were added since the last report.
aws.gamelift.queue_depth
(count)
The average number of game session placement requests in the queue with status pending.
aws.gamelift.queue_depth.maximum
(count)
The maximum number of game session placement requests in the queue with status pending.
aws.gamelift.queue_depth.minimum
(count)
The minimum number of game session placement requests in the queue with status pending.
aws.gamelift.queue_depth.sum
(count)
The sum of the number of game session placement requests in the queue with status pending.
aws.gamelift.rule_evaluations_failed
(count)
Rule evaluations during matchmaking that failed since the last report. This metric is limited to the top 50 rules.
aws.gamelift.rule_evaluations_passed
(count)
Rule evaluations during the matchmaking process that passed since the last report. This metric is limited to the top 50 rules.
aws.gamelift.server_process_abnormal_terminations
(count)
The average number of server processes that were shut due to abormal circumstances .
aws.gamelift.server_process_abnormal_terminations.maximum
(count)
The maximum number of server processes that were shut due to abormal circumstances .
aws.gamelift.server_process_abnormal_terminations.minimum
(count)
The minimum number of server processes that were shut due to abormal circumstances .
aws.gamelift.server_process_abnormal_terminations.sum
(count)
The sum of the number of server processes that were shut due to abormal circumstances .
aws.gamelift.server_process_activations
(count)
The average number of server processes that have been activated.
aws.gamelift.server_process_activations.maximum
(count)
The maximum number of server processes that have been activated.
aws.gamelift.server_process_activations.minimum
(count)
The minimum number of server processes that have been activated.
aws.gamelift.server_process_activations.sum
(count)
The sum of the number of server processes that have been activated.
aws.gamelift.server_process_terminations
(count)
The average number of server processes that have been terminated.
aws.gamelift.server_process_terminations.maximum
(count)
The maximum number of server processes that have been terminated.
aws.gamelift.server_process_terminations.minimum
(count)
The minimum number of server processes that have been terminated.
aws.gamelift.server_process_terminations.sum
(count)
The sum of the number of server processes that have been terminated.
aws.gamelift.tickets_failed
(count)
Matchmaking requests that resulted in failure since the last report.
aws.gamelift.tickets_started
(count)
New matchmaking requests that were created since the last report.
aws.gamelift.tickets_timed_out
(count)
Matchmaking requests that reached the timeout limit since the last report.
aws.gamelift.time_to_match
(gauge)
For matchmaking requests that were put into a potential match before the last report, the amount of time between ticket creation and potential match creation.
Shown as second
aws.gamelift.time_to_ticket_cancel
(gauge)
For matchmaking requests that were canceled before the last report, the amount of time between ticket creation and cancellation.
Shown as second
aws.gamelift.time_to_ticket_success
(gauge)
For matchmaking requests that succeeded before the last report, the amount of time between ticket creation and successful match placement.
Shown as second
aws.gamelift.utilized_game_servers
(count)
Game servers that are currently occupied with gameplay.

Events

The Amazon Gamelift integration does not include any events.

Service Checks

The Amazon Gamelift integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.