Add Unreal MPS telemetry sample

[Copilot]

PR #96 added a Unity MPS telemetry sample. This adds the Unreal equivalent: a drop-in dedicated server telemetry plugin intended to be wired into an existing GSDK-enabled Unreal server.

• Unreal telemetry plugin

  • Added UnrealMpsTelemetry runtime plugin scaffold.
  • Provides UMpsTelemetrySubsystem for MPS lifecycle integration.
  • Reads telemetry keys from PF_MPS_SECRET_TelemetryKey or PLAYFAB_TELEMETRY_KEY.

• Metrics collection

  • Captures aggregated server health metrics: uptime, tick count, average/max tick time, long-tick count, CPU core count, and memory stats.
  • Emits low-volume server_metrics_summary and server_metrics_final events.
  • Supports custom game/network metric providers.

• PlayFab telemetry transport

  • Queues and batches telemetry events.
  • Sends events to WriteTelemetryEvents with X-TelemetryKey.
  • Requeues failed batches with bounded queue limits.

• Documentation

  • Added Unreal integration guidance for GSDK startup/shutdown wiring.
  • Documented telemetry key setup, LocalMultiplayerAgent validation, Data Explorer queries, and production notes.
  • Linked the new sample from the root README.

Example integration:

UMpsTelemetrySubsystem* Telemetry =
    GetGameInstance()->GetSubsystem<UMpsTelemetrySubsystem>();

Telemetry->RegisterCustomMetricsProvider(
    [this](TSharedRef<FJsonObject> Payload)
    {
        Payload->SetNumberField(TEXT("networkActiveConnections"), NetworkServer->GetActiveConnectionCount());
        Payload->SetNumberField(TEXT("networkBytesReceived"), NetworkServer->GetAndResetBytesReceived());
        Payload->SetNumberField(TEXT("networkBytesSent"), NetworkServer->GetAndResetBytesSent());
    });

Telemetry->InitializeForMps(TitleId);

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds an Unreal Engine “drop-in” runtime plugin sample that collects dedicated-server metrics and flushes them to PlayFab Telemetry (WriteTelemetryEvents), mirroring the previously added Unity MPS telemetry sample.

Changes:

• Added UnrealMpsTelemetry runtime plugin scaffold with UMpsTelemetrySubsystem for MPS lifecycle wiring.
• Implemented metrics collection (tick/process stats) and a batching HTTP telemetry client with bounded queue + requeue-on-failure.
• Added Unreal-specific documentation and linked the sample from the repo root README.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
UnrealMpsTelemetry/UnrealMpsTelemetry.uplugin	Adds plugin descriptor for the Unreal telemetry sample.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/UnrealMpsTelemetry.Build.cs	Declares runtime module dependencies needed for HTTP + JSON telemetry.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Public/MpsTelemetrySubsystem.h	Introduces the public subsystem API for init/shutdown and custom metrics providers.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Private/MpsTelemetrySubsystem.cpp	Wires tick + ticker-based periodic summary collection and flush behavior.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Public/MpsTelemetrySampleConfig.h	Centralizes cadence, queue limits, and env-var telemetry key lookup.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Private/UnrealServerMetricsCollector.h	Defines the metrics collector interface and interval counters.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Private/UnrealServerMetricsCollector.cpp	Implements tick/process metric aggregation and custom provider invocation.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Private/PlayFabTelemetryClient.h	Defines the batching/queueing telemetry transport client.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Private/PlayFabTelemetryClient.cpp	Implements batching, HTTP POST to WriteTelemetryEvents, and retry/requeue.
UnrealMpsTelemetry/Source/UnrealMpsTelemetry/Private/UnrealMpsTelemetryModule.cpp	Adds module entry point and defines the plugin log category.
UnrealMpsTelemetry/README.md	Documents integration steps, telemetry key setup, and validation queries.
UnrealMpsTelemetry/.gitignore	Ignores Unreal plugin build artifacts.
README.md	Links the new Unreal telemetry sample from the root documentation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.