Skip to main content

Ingest Agent Logs

POST 
/api/v2/device/telemetry/logs

Receives log entries from agents (including third-party logs forwarded by the agent) and stores them in Elasticsearch. Logs are categorized by deviceId, group and topic.

Request​

Body

required

    deviceId stringrequired

    Device identifier that generated/forwarded the logs

    group string

    Group these logs belong to. A group encapsulates multiple topics; logs can be filtered by group and, within a group, by topic (e.g., agent, deployment).

    logs

    object[]

    required

    Array of log entries

  • Array [

    • logId string

    Unique identifier for this log entry to prevent duplicates. Auto-generated if not provided.

    timestamp date-timerequired

    Timestamp when the log was generated

    level stringrequired

    Possible values: [DEBUG, INFO, WARN, ERROR, FATAL]

    Log severity level

    message stringrequired

    Log message content

    topic string

    Topic/source of the log (e.g., agent, app-name)

    metadata object

    Additional metadata as key-value pairs

  • ]

Responses​

Logs ingested successfully

Loading...