Telemetry Sources
The Bearer API key of your user more info.
index of the first item to return
0maximum number of items to return
100Free-text search on the name of the telemetry source.
Filter by labels using a condition expression. Supports the operators ==, !=, in and not_in, combined with and (up to 20 conditions). Values must be url-encoded. An invalid expression returns 400. Examples: environment == 'production', region in ["us-east", "us-west"], environment == 'production' and severity != 'low'.
the list of telemetry sources
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
GET /api/telemetry-sources HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
the list of telemetry sources
[
{
"id": 1,
"name": "text",
"description": "text",
"type": "OTEL",
"status": "PENDING",
"integrationKey": "text",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
],
"managedBy": {
"type": "API",
"source": "text"
},
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]The Bearer API key of your user more info.
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
the created telemetry source
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
POST /api/telemetry-sources HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 181
{
"name": "text",
"description": "text",
"type": "OTEL",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
]
}the created telemetry source
{
"id": 1,
"name": "text",
"description": "text",
"type": "OTEL",
"status": "PENDING",
"integrationKey": "text",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
],
"managedBy": {
"type": "API",
"source": "text"
},
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}The Bearer API key of your user more info.
unique name of the telemetry source
the telemetry source object
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
GET /api/telemetry-sources/name/{name} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
the telemetry source object
{
"id": 1,
"name": "text",
"description": "text",
"type": "OTEL",
"status": "PENDING",
"integrationKey": "text",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
],
"managedBy": {
"type": "API",
"source": "text"
},
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}The Bearer API key of your user more info.
the id of the telemetry source
the telemetry source object
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
GET /api/telemetry-sources/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
the telemetry source object
{
"id": 1,
"name": "text",
"description": "text",
"type": "OTEL",
"status": "PENDING",
"integrationKey": "text",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
],
"managedBy": {
"type": "API",
"source": "text"
},
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}The Bearer API key of your user more info.
the id of the telemetry source
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
the updated telemetry source
The telemetry protocol of this source. Required on create and immutable afterwards.
Whether ilert is currently receiving telemetry from this source.
The credential used to send telemetry to ilert. Server-managed and read-only: it is omitted from list responses, and from the detail response for users without update permission on the telemetry source.
Prepended to the name of every service that ilert creates from the telemetry of this source, for example to keep the services of a staging environment apart from production. Leading and trailing whitespace is removed, no separator is inserted. Services that already exist are not renamed.
Appended to the name of every service that ilert creates from the telemetry of this source. Leading and trailing whitespace is removed, no separator is inserted. If prefix, service name and suffix together exceed the 255 character service name limit, the service name is shortened so that both affixes are kept in full.
PUT /api/telemetry-sources/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 181
{
"name": "text",
"description": "text",
"type": "OTEL",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
]
}the updated telemetry source
{
"id": 1,
"name": "text",
"description": "text",
"type": "OTEL",
"status": "PENDING",
"integrationKey": "text",
"serviceNamePrefix": "text",
"serviceNameSuffix": "text",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"teams": [
{
"id": 1,
"name": "text"
}
],
"managedBy": {
"type": "API",
"source": "text"
},
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}The Bearer API key of your user more info.
the id of the telemetry source
Empty body delete response
DELETE /api/telemetry-sources/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
Empty body delete response
No content
Invalidates the current integration key and issues a new one. Requires update permission. Fetch the telemetry source afterwards to read the new key.
The Bearer API key of your user more info.
the id of the telemetry source
Empty body response
PUT /api/telemetry-sources/{id}/rotate-integration-key HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
Empty body response
No content
The Bearer API key of your user more info.
the id of the telemetry source
the telemetry source statistics
When the most recent telemetry was received from this source.
GET /api/telemetry-sources/{id}/stats HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
the telemetry source statistics
{
"lastTraceAt": "2026-01-01T00:00:00.000Z"
}Fixed page size of 100. start-index must be 0 or a multiple of 100 and max-results must be 100; any other value returns 400.
The Bearer API key of your user more info.
Filter the returned label keys by prefix.
must be 0 or a multiple of 100
0must be 100
100the list of distinct label keys
GET /api/telemetry-sources/labels HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
the list of distinct label keys
[
{
"key": "text"
}
]Fixed page size of 100. start-index must be 0 or a multiple of 100 and max-results must be 100; any other value returns 400.
The Bearer API key of your user more info.
the label key
Filter the returned label values by prefix.
must be 0 or a multiple of 100
0must be 100
100the list of distinct label values
GET /api/telemetry-sources/labels/{key}/values HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
the list of distinct label values
[
{
"value": "text"
}
]Last updated
Was this helpful?