---
title: "Store telemetry metrics"
method: POST
path: "/v1/telemetry"
tags: ["Telemetry"]
---

# Store telemetry metrics

`POST /v1/telemetry`

Receive and store telemetry metrics from hive-link hosts

## Request body

- object
  - `organization_id` string, required
  - `hive_link_id` string, required
  - `hostname` string, required
  - `metric_timestamp` string, date-time, required
  - `cpu_usage_percent` number, required
  - `cpu_count` integer, required
  - `load_average` number[], required
  - `total_memory_mb` integer, required
  - `free_memory_mb` integer, required
  - `used_memory_mb` integer, required
  - `memory_usage_percent` integer, required
  - `process_memory_mb` integer, required
  - `process_memory_percent` integer, required
  - `process_rss_memory_mb` integer, nullable
  - `process_external_memory_mb` integer, nullable
  - `process_array_buffers_memory_mb` integer, nullable
  - `process_cpu_percent` number, required
  - `process_uptime` integer, required
  - `connected_printers` integer, required
  - `active_video_streams` integer, required
  - `mqtt_messages_per_second` number, required
  - `http_requests_per_second` number, required
  - `pulse_connection_state` string, nullable
  - `pulse_connected` boolean, nullable
  - `pulse_reconnect_count` integer, nullable
  - `pulse_last_connected_at` string, date-time, nullable
  - `pulse_uptime_seconds` integer, nullable
  - `pulse_message_queue_size` integer, nullable
  - `pulse_messages_dropped` integer, nullable
  - `pulse_last_ping_latency` integer, nullable
  - `pulse_routeable` boolean, nullable
  - `pulse_routeability_state` string, nullable
  - `pulse_host_subscription_pending` boolean, nullable
  - `pulse_current_session_id` integer, nullable
  - `pulse_host_subscription_session_id` integer, nullable
  - `pulse_last_host_subscribe_at` string, date-time, nullable
  - `pulse_last_session_restore_at` string, date-time, nullable
  - `pulse_disconnected_duration_ms` union
    - string
    - integer
  - `job_processor_active` boolean, nullable
  - `job_processor_last_poll_at` string, date-time, nullable
  - `job_processor_circuit_breaker_state` string, nullable
  - `jobs_processed_total` integer, nullable
  - `jobs_processing_current` integer, nullable
  - `jobs_per_minute` number, nullable
  - `jobs_success_total` integer, nullable
  - `jobs_failed_total` integer, nullable
  - `jobs_success_rate` number, nullable
  - `job_retry_count` integer, nullable
  - `avg_job_duration_ms` integer, nullable
  - `p50_job_duration_ms` integer, nullable
  - `p95_job_duration_ms` integer, nullable
  - `slowest_job_duration_ms` integer, nullable

## Response `200`

Default Response

- object
  - `success` boolean
  - `id` string

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/versions/3b06bcb5f808/schema)