This is the 5.4.0 release of the C# server SDK for Amazon GameLift Servers.

This release adds the ability to collect and publish telemetry metrics for game servers running on fleets. You can leverage both pre-defined metrics and custom metrics, publishing them to Amazon Managed Service for Prometheus or Amazon CloudWatch. This data can be visualized through ready-to-use dashboards (via Amazon Managed Grafana or Amazon CloudWatch) to help optimize game resource utilization, improve player experience, and identify and resolve potential operational issues.

For more information on monitoring resources using telemetry metrics on Amazon GameLift Servers, please review the telemetry metrics README or visit the Amazon GameLift Servers documentation.

Changelog

• Adds support for publishing built-in and custom telemetry metrics, with pre-built dashboards for visualizing usage data.

For the complete list of changes, see the full release notes.

• Adds or improves client-side validation in all server SDK actions.
• Adds more specific and improved error responses to API errors.
• Adds default logic to the onProcessTerminate() callback that terminates the game server process when this callback is invoked.
• Adds idempotency token support to allow InitSDK() retries to succeed.
• Includes autoBackfillMode in the data passed in the OnUpdateGameSession() callback.

• Adds support for .NET 8.0 as a target framework. The plugin now supports the use of .NET Framework 4.6.2, .NET 6.0, and .NET 8.0.

• Improved the reliability of the SDK by adding automatic reconnection in the event of network interruption.

• Add support for GameLift Anywhere. This SDK version contains backwards-incompatible changes.
• Update InitSDK() API to take a ServerParameters parameter.
• Remove TerminateGameSession() API
• Rename GetInstanceCertificate() API to GetComputeCertificate()
• Add GetFleetRoleCredentials(GetFleetRoleCredentialsRequest) API
• Remove dependency on Protobuf
• Remove dependency on WebSocketSharpFork
• Upgrade log4net dependency from 2.0.5 to 2.0.15
• Upgrade Newtonsoft.Json from 9.0.1 to 13.0.1
• Add dependency on WebSocketSharp 1.0.3-rc11
• Add dependency on Polly 5.9.0
• Add SDK unit tests using dependency NUnit 3.13.3 and Moq 4.16.1
• Updated Amazon GameLift C# Server SDK to support .NET 6
• Updated sample code for .NET 6

• Fixed bug with StartMatchBackfill