Telemetry

Telemetry items are how a package publishes state for the Console, or other packages, to see:

PackageHost.PushTelemetryItem("SunInfo", new SunInfo { Sunrise = ..., Sunset = ... });

[TelemetryItem] marks a type as a telemetry payload - documentation/tooling only, it doesn't change serialization.

Every telemetry item pushed shows up automatically on the Console's Telemetry page - nothing to register or configure on the Console side:

Consuming another package's telemetry

Use [TelemetryItemLink] on a property and call PackageHost.RegisterTelemetryItemLinks(this) once. The field stays in sync automatically:

[TelemetryItemLink("Weather", "CurrentTemperature")]
public double? OutsideTemperature { get; set; }

Or subscribe imperatively instead of via a property:

PackageHost.RegisterTelemetryItemCallback(item => { /* ... */ }, package: "Weather", name: "CurrentTemperature");