Перейти к основному содержимому

Наблюдаемость

Каждая запись наблюдается как один субъект в пяти измерениях:

  1. state — текущие spec, lifecycle phase, owner, labels, timestamps и состояние конкретного kind;
  2. events — durable history записи, включая commands и переходы activities;
  3. logs — структурированная телеметрия, отнесённая к записи;
  4. metrics — её metric series и samples;
  5. trace — spans workflow и activities, действующих от её имени.

Измерения принадлежат записи, а не конкретному runner или backend. Поэтому одни команды работают для рана, агента, артефакта, Docker container, Kubernetes object, source и системной записи:

$ graphenectl get docker/pg-exporter
$ graphenectl events docker/pg-exporter
$ graphenectl docker/pg-exporter logs -f
$ graphenectl docker/pg-exporter metrics -f
$ graphenectl docker/pg-exporter trace -f

Атрибуция​

Interceptors pipeline- и server-workers добавляют к телеметрии ref записи и контекст её run, agent, namespace и contour. Observation beats агента переносят вывод host commands и необязательные Prometheus scrape samples ресурса на машине. Поэтому библиотечные ресурсы наблюдаемы без собственного transport в каждой библиотеке.

История и live follow​

Events читаются из durable workflow history. Logs, metrics и traces сначала получают snapshot из настроенного backend, а с -f продолжаются из live OTLP fan-out сервера. Для медленных потребителей потерянные signals считаются явно, а не скрываются за ложным обещанием полноты.

Dev-стек использует VictoriaLogs, VictoriaMetrics и VictoriaTraces. Это адаптеры за стандартными LogsQL, PromQL, Jaeger и OTLP surfaces, а не часть record model Graphene.

Формы команд и raw backend queries описаны в разделе Наблюдение в graphenectl.