Skip to main content

Third-party metric ingestion endpoint.

POST 
/api/v2/telemetry/metrics

Public v2 surface for external reporters to push metrics to this agent. Uses the agent's own third-party DTO contract — decoupled from the internal A2A wire types — and stores entries locally categorized by deviceId and topic. When deviceId is empty, this agent's own device ID is used; when topic is absent it defaults to "agent".

Request​

Body

required

    deviceId string

    Device the metrics belong to. When empty, this agent's own device ID is used.

    metrics

    object[]

    required

    Metric entries to ingest.

  • Array [

    • labels object

    Additional labels/tags for the metric.

    metricId stringnullable

    Unique identifier for this metric entry to prevent duplicates. Auto-generated when absent.

    name stringrequired

    Metric name (e.g. cpu_usage, memory_usage).

    timestamp date-timerequired

    Timestamp when the metric was recorded.

    unit stringnullable

    Unit of the metric (e.g. percent, bytes, ms).

    value doublerequired

    Metric numeric value.

  • ]

    • topic stringnullable

    Topic category for these metrics.

Responses​

Metrics ingested successfully

Loading...