Документация

Добро пожаловать в Actaflow

Actaflow — это unified observability платформа для метрик, трейсов и логов. Этот раздел описывает, как начать работу с платформой, интегрировать её в вашу инфраструктуру и получить максимум из данных.

Основные компоненты

Платформа состоит из четырёх уровней. Каждый уровень независимо масштабируется и отказоустойчив.

1. Actaflow Collector

Daemon, который устанавливается рядом с вашими сервисами (как DaemonSet в Kubernetes или systemd-unit на VM). Принимает данные из OTLP, Prometheus remote-write, StatsD, Fluent Bit. Батчит и сжимает перед отправкой в ingest-слой.

# Минимальная конфигурация collector'а
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318
  hostmetrics:
    collection_interval: 30s
    scrapers:
      cpu: {}
      memory: {}
      disk: {}
      network: {}

exporters:
  otlp/actaflow:
    endpoint: ingest.actaflow.tech:4317
    tls:
      cert_file: /etc/actaflow/cert.pem
      key_file:  /etc/actaflow/key.pem
    headers:
      x-actaflow-api-key: ${ACTAFLOW_API_KEY}

service:
  pipelines:
    traces:
      receivers:  [otlp]
      exporters:  [otlp/actaflow]
    metrics:
      receivers:  [otlp, hostmetrics]
      exporters:  [otlp/actaflow]
    logs:
      receivers:  [otlp]
      exporters:  [otlp/actaflow]

2. Ingest layer

Stateless-сервис, принимает OTLP от коллекторов, выполняет tail-sampling для трейсов, PII-маскинг для логов и пишет в ClickHouse. Реплицируется горизонтально; throughput растёт линейно с числом инстансов.

3. Storage (ClickHouse)

Sharded + replicated ClickHouse-кластер. Данные автоматически делятся на hot (NVMe, 7 дней), warm (SSD, 90 дней), cold (S3, до 5 лет). Materialized views считают pre-aggregated rollups для common queries.

4. Query + UI

Stateless API для выполнения запросов (P95 < 80ms), GraphQL-эндпоинтов для dashboard'ов и alert evaluation. RBAC на всех уровнях, audit log всех запросов.

Quickstart

Если у вас уже есть Kubernetes-кластер, самый быстрый путь — Helm chart:

# Добавьте репозиторий
helm repo add actaflow https://charts.actaflow.tech
helm repo update

# Создайте namespace
kubectl create namespace observability

# Сгенерируйте API-ключ в личном кабинете и положите в secret
kubectl create secret generic actaflow-api \
  --from-literal=key=$ACTAFLOW_API_KEY -n observability

# Установите collector как DaemonSet
helm install actaflow-collector actaflow/collector \
  --namespace observability \
  --set cluster.name=$(hostname) \
  --set api.secretName=actaflow-api

# Проверьте, что поды поднялись
kubectl get pods -n observability -l app.kubernetes.io/name=collector
# NAME                       READY   STATUS    RESTARTS  AGE
# collector-abc12            1/1     Running   0         2m
# collector-def34            1/1     Running   0         2m
# collector-ghi56            1/1     Running   0         2m

Через 30-60 секунд данные потекут в dashboard. Откройте live demo или свой тенант, чтобы увидеть метрики и трейсы.

Подробнее — в полном quickstart гайде.

Что читать дальше

Поддержка

Застряли? Команда поддержки отвечает по будням 09:00–21:00 МСК, для Enterprise-клиентов — 24/7. Каналы:

• Email: support@actaflow.tech
• Telegram: @actaflow_support
• Community: GitHub Discussions
• Incident hotline (Enterprise): +7 (495) 123-45-67, доб. 911

Перед обращением полезно приложить вывод actaflow-collector diagnose > diag.tar.gz — это ускорит разбор.