---
title: "Push events as logs and CPU and memory as metrics to an OTLP/HTTP endpoint."
method: POST
path: "/v1/otel-exports"
tags: ["observability"]
---

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

`POST /v1/otel-exports`

## Request

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

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.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `endpoint` string, required: The OTLP/HTTP base URL, as OTEL_EXPORTER_OTLP_ENDPOINT: logs go to <endpoint>/v1/logs and metrics to <endpoint>/v1/metrics.
  - `headers` object: 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.
  - `signals` string[]: What to send: "logs" (events as log records) and "metrics" (CPU and memory gauges). Both when omitted.

## Response `200`

Success

- object
  - `id` string, required
  - `endpoint` string, required
  - `headerNames` string[]: Header names only; values are never shown.
  - `signals` string[], required
  - `enabled` boolean, required
  - `createdAt` string
  - `updatedAt` string
  - `lastAttemptAt` string, nullable
  - `lastSuccessAt` string, nullable
  - `lastError` string, nullable
  - `failures` integer
  - `exportedEvents` integer
  - `exportedPoints` integer

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/e76cd8f6dcb4?raw)