Claude Code

Конфигурация сбора данных содержит конфигурации для сбора событий локального Claude Code и логов Claude Desktop с помощью Smart Monitor Data Collector и Smart Beat Manager.

Модель данных

Данные нормализуются в индекс gen_ai_events и используют совместимые поля пространства имён gen_ai.*: агент, модель, usage токенов, routing metadata, статус выполнения и параметры локального окружения.

Состав конфигурации сбора данных

1. sm_data_collector_pipelines – конфигурационный файл pipeline Smart Monitor Data Collector:
   • claude_code.conf – сессии Claude Code и логи Claude Desktop → gen_ai_events.
2. opensearch – шаблон индекса gen_ai_events.
3. sample – примеры исходных (original) и разобранных (expected) данных.
4. SmartBeatManager – приложение Filebeat:
   • filebeat_claude_code – чтение JSONL-сессий Claude Code и логов Claude Desktop.

Предварительные требования

Предполагается, что ПО установлено по стандартным путям:

/app/logstash/
/app/smartBeatManager/
/app/smartBeat/

Используемые каталоги:

/app/logstash/config/conf.d
/app/logstash/config/pipelines.yml
/app/smartBeatManager/apps
/app/smartBeatManager/binaries
/app/smartBeatManager/etc/serverclasses.yml

При нестандартных путях проверьте конфигурационные файлы и скорректируйте пути вручную.

1. Настройка Smart Monitor Data Collector

1.1. Размещение pipeline-конфигов

Содержимое каталога sm_data_collector_pipelines/ разместите в /app/logstash/config/conf.d.

1.2. Ключи logstash.keystore

В logstash.keystore должен присутствовать ключ:

• ES_PWD — пароль пользователя logstash для подключения к Smart Monitor.

1.3. Подключение pipeline в pipelines.yml

В файл /app/logstash/config/pipelines.yml добавьте:

### Claude Code

- pipeline.id: claude_code
  path.config: "/app/logstash/config/conf.d/claude_code.conf"
  pipeline.workers: 1

Pipeline собирает документ из нескольких строк сессии, поэтому ему задан pipeline.workers: 1.

1.4. Замена токенов в конфигах

В размещённом claude_code.conf замените:

• HOST:PORT в output.opensearch — адрес и порт Smart Monitor;
• PORT в input.beats — порт приёма данных от Smart Beat.

1.5. Перезапуск Logstash

systemctl restart logstash

2. Настройка Smart Beat Manager

2.1. Размещение приложений и binaries

Каталог SmartBeatManager/apps/filebeat_claude_code разместите в /app/smartBeatManager/apps, а совместимый OSS-дистрибутив Filebeat — в /app/smartBeatManager/binaries.

2.2. Параметры приложения

В filebeat.yml замените:

• HOST:PORT — адрес и порт Smart Monitor Data Collector;
• <HOME> — домашний каталог пользователя.

Источники, из которых собираются данные:

Логи Claude Desktop расположены по macOS-пути. На других ОС, если приложение Claude Desktop не используется, этот вход можно отключить — сбор сессий Claude Code от этого не зависит.

Поток данных

Соответствие конфигов и индексов

Кто использует данные