Documentation

Agent installation

Download and install the agent on any Linux host:

curl -sSL https://cloud-telemetry-api.com/install.sh | sh

Or via package manager:

# Debian/Ubuntu
apt-get install ct-agent

# RHEL/CentOS
yum install ct-agent

Configuration

Agent configuration lives at /etc/ct-agent/config.yaml:

api_key: "ct_live_..."
endpoint: "https://cloud-telemetry-api.com"
inputs:
  - type: prometheus
    listen: "0.0.0.0:9090"
  - type: statsd
    listen: "0.0.0.0:8125"
outputs:
  - type: datadog
    api_key: "${DATADOG_KEY}"
  - type: s3
    bucket: "my-metrics-archive"
    region: "us-east-1"
sampling:
  rate: 0.1  # 10% sampling for high-cardinality metrics

API reference

Base URL: https://cloud-telemetry-api.com/v1

POST /v1/telemetry/ingest

Submit metrics directly via API (for environments where the agent can't be deployed):

curl -X POST https://cloud-telemetry-api.com/v1/telemetry/ingest \
  -H "Authorization: Bearer ct_live_..." \
  -H "Content-Type: application/json" \
  -d '{"metrics":[{"name":"http.req.duration","value":142,"unit":"ms","tags":{"service":"api","env":"prod"}}]}'

GET /v1/agents

List all registered agents and their health status.

GET /v1/pipelines

Get pipeline throughput, error rates, and configured routes.

Full API reference: coming soon. For early access contact hello@cloud-telemetry-api.com