---
title: "Track telemetry events"
method: POST
path: "/track"
---

# Track telemetry events

`POST /track`

This operation sends a sequence of telemetry events that will be monitored by Azure Monitor.

## Request body

- TelemetryEnvelope[]
  - `ver` number — Envelope version. For internal use only. By assigning this the default, it will not be serialized within the payload unless changed to a value other than #1.
  - `name` string, required — Type name of telemetry data item.
  - `time` string, date-time, required — Event date time when telemetry item was created. This is the wall clock time on the client when the event was generated. There is no guarantee that the client's time is accurate. This field must be formatted in UTC ISO 8601 format, with a trailing 'Z' character, as described publicly on https://en.wikipedia.org/wiki/ISO_8601#UTC. Note: the number of decimal seconds digits provided are variable (and unspecified). Consumers should handle this, i.e. managed code consumers should not use format 'O' for parsing as it specifies a fixed length. Example: 2009-06-15T13:45:30.0000000Z.
  - `sampleRate` number, float — Sampling rate used in application. This telemetry item represents 100 / sampleRate actual telemetry items.
  - `seq` string — Sequence field used to track absolute order of uploaded events.
  - `iKey` string — The instrumentation key of the Application Insights resource.
  - `tags` object — Key/value collection of context properties. See ContextTagKeys for information on available properties.
  - `data` Base — Data struct to contain only C section with custom fields.
    - `baseType` string — Name of item (B section) if any. If telemetry data is derived straight from this, this should be null.
    - `baseData` Domain — The abstract common base of all domains.
      - `ver` integer, required — Schema version

## Response `200`

All of the telemetry items were accepted and processed.

- TrackResponse — Response containing the status of each telemetry item.
  - `itemsReceived` number — The number of items received.
  - `itemsAccepted` number — The number of items accepted.
  - `errors` ErrorDetails[] — An array of error detail objects.
    - `index` number — The index in the original payload of the item.
    - `statusCode` number — The item specific [HTTP Response status code](#Response Status Codes).
    - `message` string — The error message.

## Other responses

- `206` — Partial success. Some of the telemetry items were accepted and processed.
- `400` — Bad Request
- `402` — Payment Required
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/azure/apis/applicationinsightsclient.md) · [All operations](https://skmtc.dev/azure/apis/applicationinsightsclient/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/applicationinsightsclient/revisions/ebd593376c74/schema)