Skip to main content
POST
/
live-tail
Initiate a live tail job
curl --request POST \
  --url https://api.eu.bronto.io/live-tail \
  --header 'Content-Type: application/json' \
  --header 'X-BRONTO-API-KEY: <api-key>' \
  --data @- <<EOF
{
  "from": "a16fe455-ffdc-40bb-bfc2-27d4b318259e",
  "from_expr": "log_id = '8f759283-cc85-47d9-a668-494692e114f6'",
  "where": "ERROR"
}
EOF
{
  "job_id": "a16fe455-ffdc-40bb-bfc2-27d4b318259e"
}

Authorizations

​
X-BRONTO-API-KEY
string
header
required

Body

application/json
​
from
string[]
required

List of log IDs to tail

Example:

"a16fe455-ffdc-40bb-bfc2-27d4b318259e"

​
from_expr
string

Expression which selects logs to tail

Example:

"log_id = '8f759283-cc85-47d9-a668-494692e114f6'"

​
where
string

Optional filter to apply to log events in the tail stream

Example:

"ERROR"

Response

Job created successfully

​
job_id
string

Unique identifier for the live tail job; used to poll for events

Example:

"a16fe455-ffdc-40bb-bfc2-27d4b318259e"