> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodostatus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics Ingestion

> Push internal metrics for automatic health detection

Push metrics from your applications to automatically detect and respond to health issues.

## How It Works

Send metrics like error rates, response times, and resource usage. Kodo analyzes these metrics and automatically updates service status based on configurable thresholds.

## Default Thresholds

| Metric        | Degraded | Partial Outage | Major Outage |
| ------------- | -------- | -------------- | ------------ |
| Error rate    | >1%      | >10%           | >50%         |
| Response time | >1000ms  | >3000ms        | >10000ms     |
| CPU usage     | >70%     | >85%           | >95%         |
| Memory usage  | >70%     | >85%           | >95%         |

## Pushing Metrics

```bash theme={null}
curl -X POST "https://kodostatus.com/api/metrics/ingest" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key",
    "service": "API Gateway",
    "metrics": {
      "error_rate": 2.5,
      "response_time_ms": 245,
      "cpu_percent": 65,
      "memory_percent": 78
    }
  }'
```

<Note>
  The API key is passed in the body, not as a header. This allows easier integration from environments where headers are difficult to set.
</Note>

## Available Metrics

| Metric             | Type   | Description              |
| ------------------ | ------ | ------------------------ |
| `error_rate`       | number | Error percentage (0-100) |
| `response_time_ms` | number | Average response time    |
| `cpu_percent`      | number | CPU usage (0-100)        |
| `memory_percent`   | number | Memory usage (0-100)     |
| `request_count`    | number | Requests in this period  |
| `error_count`      | number | Errors in this period    |

## Integration Examples

<Tabs>
  <Tab title="Node.js">
    ```javascript theme={null}
    // Push metrics every minute
    setInterval(async () => {
      await fetch('https://kodostatus.com/api/metrics/ingest', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          api_key: process.env.KODO_API_KEY,
          service: 'API Gateway',
          metrics: {
            error_rate: calculateErrorRate(),
            response_time_ms: getAvgResponseTime(),
            request_count: getRequestCount()
          }
        })
      });
    }, 60000);
    ```
  </Tab>

  <Tab title="Express Middleware">
    ```javascript theme={null}
    const metrics = { requests: 0, errors: 0, totalTime: 0 };

    app.use((req, res, next) => {
      const start = Date.now();
      res.on('finish', () => {
        metrics.requests++;
        metrics.totalTime += Date.now() - start;
        if (res.statusCode >= 500) metrics.errors++;
      });
      next();
    });

    // Push every minute
    setInterval(() => {
      pushMetrics({
        error_rate: (metrics.errors / metrics.requests) * 100,
        response_time_ms: metrics.totalTime / metrics.requests
      });
      // Reset counters
      metrics.requests = metrics.errors = metrics.totalTime = 0;
    }, 60000);
    ```
  </Tab>
</Tabs>

## Response

```json theme={null}
{
  "success": true,
  "received_at": "2024-01-15T10:30:00Z",
  "health_status": "operational",
  "alerts": []
}
```

If thresholds are exceeded:

```json theme={null}
{
  "success": true,
  "received_at": "2024-01-15T10:30:00Z",
  "health_status": "degraded",
  "alerts": [
    {
      "metric": "error_rate",
      "value": 12.5,
      "threshold": 10,
      "severity": "partial_outage"
    }
  ]
}
```

## Custom Thresholds

Configure custom thresholds per service in the dashboard under **Services > \[Service] > Metrics**.