Logs API

Ingest log events and search through your logs using DSL queries.

search(params: SearchParams): Promise<SearchResponse>

Search logs with DSL query support

Parameters

Name	Type	Required	Description
tsFrom	string	Yes	Start timestamp (ISO 8601)
tsTo	string	Yes	End timestamp (ISO 8601)
query	string	No	DSL query string
limit	number	No	Maximum results (default: 100, max: 1000)
after	string	No	Pagination token

Example

const results = await client.logs.search({
  tsFrom: '2025-01-15T00:00:00Z',
  tsTo: '2025-01-15T23:59:59Z',
  query: "level = 'error' AND service = 'api'",
  limit: 100
})

console.log(`Found ${results.data.length} logs`)
console.log(`Has more: ${results.pagination.hasMore}`)

ingest(events: LogEvent[]): Promise<IngestResponse>

Ingest log events into the system

Parameters

Array of log events to ingest

Example

const response = await client.logs.ingest([
  {
    ts: new Date().toISOString(),
    level: 'info',
    msg: 'User logged in',
    service: 'api',
    user_id: 'user-123'
  },
  {
    ts: new Date().toISOString(),
    level: 'error',
    msg: 'Payment failed',
    service: 'payment',
    req_id: 'req-456'
  }
])

console.log(`Ingested: ${response.ingested}`)
if (response.rejected) {
  console.log(`Rejected: ${response.rejected}`)
}