Argus
API Reference

Ingest Endpoint

Send metrics to Argus via the ingest API.

Endpoint

POST /api/v1/ingest

Headers

HeaderRequiredDescription
X-API-KeyYesYour API key
Content-TypeYesapplication/json

Request Body

{
  "host": "web-server-01",
  "timestamp": "2024-01-15T14:30:00Z",
  "metrics": {
    "cpu_percent": 42.5,
    "memory_percent": 68.2,
    "disk_percent": 55.0
  },
  "tags": {
    "environment": "production",
    "service": "api-gateway",
    "region": "us-east-1"
  },
  "docker_containers": [
    {
      "name": "nginx",
      "image": "nginx:1.25",
      "status": "running",
      "cpu_percent": 2.1,
      "memory_usage": 52428800
    }
  ],
  "processes": [
    {
      "name": "node",
      "pid": 1234,
      "cpu_percent": 15.3,
      "memory_rss": 104857600
    }
  ]
}

Response

Success (200)

{
  "status": "ok",
  "events_accepted": 1
}

Errors

StatusDescription
401Invalid or missing API key
429Event quota exceeded (purchase PAYG credits or upgrade)
422Invalid request body

Example

curl -X POST https://api.tryargus.cloud/api/v1/ingest \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "web-server-01",
    "metrics": {
      "cpu_percent": 42.5,
      "memory_percent": 68.2
    }
  }'

On this page