Skip to main content

Request Item Fields

FieldTypeRequiredNotes
timestampISO datetimeYesUTC recommended
environmentstringYesExample: production, staging
methodstringYesHTTP method, normalized uppercase
pathstringYesEndpoint path (ex. /v1/orders)
status_codeintegerYesHTTP status code
response_time_msnumberYesDuration in milliseconds
request_sizeintegerYesRequest payload bytes
response_sizeintegerYesResponse payload bytes
ip_addressstringNoOptional source IP
user_agentstringNoConsumer identifier fallback
request_payloadstringNoRaw request body sample (truncated server-side)
response_payloadstringNoRaw response body sample (truncated server-side)

Batch Envelope

{
  "requests": [
    { "...request item...": "..." }
  ]
}

Validation Notes

  • Keep batch size under 1000
  • Ensure timestamps are valid ISO-8601
  • Use stable path format for accurate endpoint grouping
  • Ensure status codes are in valid HTTP ranges
  • Payload fields are stored as text and truncated to safe limits
Before sending telemetry from SDK:
  1. Uppercase method
  2. Remove query string from path
  3. Convert durations to integer milliseconds
  4. Clamp negative sizes/timings to 0