observability

Push events as logs and CPU and memory as metrics to an OTLP/HTTP endpoint.

Any OpenTelemetry backend that takes OTLP/HTTP with JSON: an OpenTelemetry Collector, Grafana Cloud, Honeycomb, Datadog, New Relic and others. Events go to <endpoint>/v1/logs as log records; readings to <endpoint>/v1/metrics as the gauges runtime.sandbox.cpu.utilization, runtime.sandbox.cpu.usage, runtime.sandbox.memory.usage and runtime.sandbox.memory.limit, one resource per sandbox. Pushed about every 30 seconds, from the moment the export is made. A failed push is retried, backing off to an hour, and resent from where it stopped while the data is kept. At most 3 an account.

post/v1/otel-exports

Request

  • Base URL: https://api.withruntime.com
  • URL: https://api.withruntime.com/v1/otel-exports
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replaying the same key with the same request within 24 hours returns the first result and never repeats the effect. A refusal is not kept: a request refused before it ran (no_capacity, busy, a limit) runs afresh when sent again with its key. The SDKs send one automatically; the server makes one when absent and returns it in the idempotency-key response header.

Request body

endpointstring required

The OTLP/HTTP base URL, as OTEL_EXPORTER_OTLP_ENDPOINT: logs go to <endpoint>/v1/logs and metrics to <endpoint>/v1/metrics.

headersobject

Sent with every push, for the endpoint's authentication: Authorization, DD-API-KEY, x-honeycomb-team and so on. Stored where only the sender reads them; never shown again.

signalsstring[]

What to send: "logs" (events as log records) and "metrics" (CPU and memory gauges). Both when omitted.

Response

Success

idstring required
endpointstring required
headerNamesstring[]

Header names only; values are never shown.

signalsstring[] required
enabledboolean required
createdAtstring
updatedAtstring
lastAttemptAtstring nullable
lastSuccessAtstring nullable
lastErrorstring nullable
failuresinteger
exportedEventsinteger
exportedPointsinteger

Changes

No recorded changes to this operation across all 1 revision of this API.