Quickstart

Send data to insmn.digital in three steps: grab an ingest key from the console, point an agent at your regional endpoint, and open the dashboard. Most fleets see their first series in under a minute.

Endpoints

Pick the endpoint closest to your workloads. Telemetry stays resident in the region you choose.

OpenTelemetry

insmn.digital speaks OTLP over HTTP natively. Configure the OpenTelemetry Collector to export metrics, traces and logs to your regional endpoint.

# otel-collector config — exports to RU Central
exporters:
  otlphttp/insmn:
    endpoint: "https://ru-4.insmn.digital/v1/otlp"
    headers:
      X-Insmn-Key: "${INSMN_INGEST_KEY}"
    compression: gzip

service:
  pipelines:
    metrics:  { exporters: [otlphttp/insmn] }
    traces:   { exporters: [otlphttp/insmn] }
    logs:     { exporters: [otlphttp/insmn] }

export OTEL_EXPORTER_OTLP_ENDPOINT="https://ru-4.insmn.digital/v1/otlp"
export OTEL_EXPORTER_OTLP_HEADERS="X-Insmn-Key=${INSMN_INGEST_KEY}"
export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"

Prometheus

Already running Prometheus? Add a remote_write block — no agent swap required. Samples are forwarded continuously over a persistent HTTP/2 connection.

# prometheus.yml
remote_write:
  - url: "https://ru-4.insmn.digital/api/v1/write"
    headers:
      X-Insmn-Key: "${INSMN_INGEST_KEY}"
    queue_config:
      max_samples_per_send: 2000
      capacity: 10000

Ingestion API

For custom pipelines, post protobuf or JSON directly. The endpoint returns 204 on accept and 429 when you exceed your key's rate limit.

curl -X POST https://ru-4.insmn.digital/api/v1/write \
  -H "X-Insmn-Key: $INSMN_INGEST_KEY" \
  -H "Content-Type: application/x-protobuf" \
  -H "Content-Encoding: snappy" \
  --data-binary @batch.pb

Regions & residency

Each endpoint writes to storage physically located in that region. Telemetry sent to ru-4.insmn.digital is processed and retained in RU-CENTRAL and is never replicated outside the region unless you explicitly enable cross-region read.

• Ingestion, indexing and query all run region-local.
• Dashboards and alert rules are global; the data they read stays regional.
• Default retention is 30 days for metrics, 14 days for logs and traces.

Rate limits

Limits are per ingest key and reset every second. Exceeding them returns 429 with a Retry-After header; well-behaved agents back off automatically.