Агент Docker

Агент Docker от Status200 — это один контейнер, который запускается на Docker-хосте. Он читает статистику и файлы логов каждого контейнера на хосте и отправляет их в Status200, где хост появляется со своими контейнерами, метриками и логами. Второй контейнер, ИИ-агент Docker, позволяет Status200 AI расследовать проблемы на хосте. Мониторы Docker оповещают о том, что отправляет агент.

Как это работает#

Агент — это OpenTelemetry Collector со встроенной конфигурацией Status200. Через сокет Docker он читает статистику каждого контейнера каждые 30 секунд и каждые 5 минут перечисляет все контейнеры, образы, сети и тома. Он следит за файлами логов контейнеров и отправляет всё на ваш URL Status200 по OTLP с ключом приёма, который вы ему передаёте.

Хост регистрируется по своим первым данным под именем, которое вы задаёте в DOCKER_HOST_NAME. ИИ-агент необязателен: если его не устанавливать, коллектор работает так же.

Перед началом#

• Docker Engine 20.10 или новее и доступ root на хосте: агент читает /var/run/docker.sock.
• Docker Compose v2 (команда docker compose), если вы устанавливаете через Docker Compose.
• Ключ приёма. Создайте его в разделе Настройки проекта → Телеметрия и APM → Ключи приема и скопируйте значение.
• Исходящий HTTPS с хоста на ваш URL Status200.
• Для логов контейнеров — контейнеры, которые используют драйвер логов Docker json-file, используемый Docker по умолчанию. См. Для логов контейнеров нужен драйвер логов json-file.

Установка агента#

1. Запустите агент#

   Замените YOUR_STATUS200_URL своим URL Status200, YOUR_TELEMETRY_INGESTION_TOKEN — ключом приёма, а my-docker-host — именем этого хоста, например prod-docker-01. Под этим именем хост появится в Status200, поэтому не меняйте его: новое имя регистрирует новый хост.

   Docker CLIDocker Compose

   Docker CLI

   Bash

   docker run -d \
     --name status200-docker-agent \
     --user 0:0 \
     --restart unless-stopped \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e DOCKER_HOST_NAME="my-docker-host" \
     status200/docker-agent:release

   Затем рядом запустите ИИ-агент с теми же значениями. ИИ-расследования включены по умолчанию: пока Status200 AI расследует инцидент или оповещение на этом хосте, он выполняет через ИИ-агент команды docker только для чтения и ничего не меняет, если вы не разрешите исправления. Чтобы установить без ИИ-расследований, пропустите эту команду.

   Bash

   docker run -d \
     --name status200-docker-ai-agent \
     --user 0:0 \
     --restart unless-stopped \
     --read-only --tmpfs /tmp \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e STATUS200_AI_AGENT_RESOURCE_TYPE=docker \
     -e DOCKER_HOST_NAME="my-docker-host" \
     status200/resource-ai-agent:release

   Docker Compose

   Сохраните это как docker-compose.yml в папке на хосте. Второй сервис — ИИ-агент: уберите его, чтобы запускать коллектор без ИИ-расследований.

   docker-compose.ymlYAML

   services:
     status200-docker-agent:
       image: status200/docker-agent:release
       container_name: status200-docker-agent
       user: "0:0"
       restart: unless-stopped
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
         - /var/lib/docker/containers:/var/lib/docker/containers:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - DOCKER_HOST_NAME=my-docker-host
       logging:
         driver: json-file
         options:
           max-size: "10m"
           max-file: "3"
     status200-docker-ai-agent:
       image: status200/resource-ai-agent:release
       container_name: status200-docker-ai-agent
       user: "0:0"
       restart: unless-stopped
       read_only: true
       tmpfs:
         - /tmp
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - STATUS200_AI_AGENT_RESOURCE_TYPE=docker
         - DOCKER_HOST_NAME=my-docker-host

   Запустите его в этой папке:

   Bash

   docker compose up -d

2. Убедитесь, что агент работает#

   Bash

   docker ps --filter name=status200-docker-agent
   docker logs -f status200-docker-agent

   Когда коллектор запустится, в логах должна появиться такая строка:

   Everything is ready. Begin running and processing data.

3. Найдите хост в Status200#

   Откройте Продукты → Инфраструктура → Docker → Все хосты. Хост появится под своим DOCKER_HOST_NAME примерно через минуту, со своими контейнерами, метриками и логами. ИИ-агент отображается как подключённый на странице хоста ИИ-агент и внизу его страницы Обзор. Страница Топология хоста рисует его проекты Compose, контейнеры, образы, сети и тома на одной карте: см. Топология.

Переменные окружения#

Чтобы изменить значение, удалите агент и снова выполните его команду (Docker CLI) или отредактируйте docker-compose.yml и выполните docker compose up -d (Docker Compose).

Что собирает агент#

Метрики и логи каждого контейнера хранятся под сервисом, названным по имени контейнера. Каждая строка лога получает важность по уровню, который в ней указан, например [ERROR], level=warn или {"level":"info"}; строка без уровня получает важность своего потока: stderr — ERROR, stdout — INFO. Строки, начинающиеся с пробела или закрывающей скобки, присоединяются к предыдущей строке, поэтому трассировка стека приходит одной записью. Собственные логи агента не отправляются.

Мониторинг Docker перечисляет все метрики и объясняет их значение.

Для логов контейнеров нужен драйвер логов json-file#

Агент следит за /var/lib/docker/containers/*/*-json.log — файлами, которые пишет драйвер логов Docker json-file. Контейнер с другим драйвером не оставляет файла для чтения: local пишет двоичные файлы, а journald, syslog, fluentd и gelf отправляют логи в другое место. Его метрики по-прежнему поступают, а логи — нет.

Проверьте драйвер логов контейнера и значение по умолчанию у демона:

docker inspect <container> --format '{{.HostConfig.LogConfig.Type}}'
docker info --format '{{.LoggingDriver}}'

Переведите сервис Compose на json-file с ротацией:

services:
  my-app:
    image: my-app:latest
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "5"

Или сделайте его значением по умолчанию для всех контейнеров, создаваемых после этого, в /etc/docker/daemon.json:

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "5"
  }
}

Затем перезапустите Docker и пересоздайте контейнеры. Контейнер сохраняет драйвер логов, с которым был создан, поэтому перезапуска недостаточно.

Обновление агента#

Когда агент старше вашего Status200, рядом с Версия агента на странице хоста Обзор появляется предупреждающий значок. Нажмите на него, чтобы увидеть эти команды.

docker pull status200/docker-agent:release
docker pull status200/resource-ai-agent:release
docker rm -f status200-docker-agent status200-docker-ai-agent

docker compose pull
docker compose up -d

Тег release всегда указывает на новейший выпуск. Чтобы закрепить версию, используйте status200/docker-agent:<version>, например status200/docker-agent:10.0.31. Тот же образ есть в GitHub Container Registry как ghcr.io/status200/docker-agent:release.

Удаление агента#

docker rm -f status200-docker-agent
docker rm -f status200-docker-ai-agent

docker compose down

Хост остаётся в Status200 с отправленными данными. Если он больше не нужен, удалите его через Удалить хост в его меню.

ИИ-агент#

Команды и файл Compose выше, install.sh агента Docker и docker-compose.yml в его [каталоге DockerAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerAgent) запускают ИИ-агент Docker: второй контейнер, status200-docker-ai-agent (образ status200/resource-ai-agent:release), который выполняет команды docker только для чтения, запрашиваемые Status200 AI при расследовании инцидента или оповещения на этом хосте, — docker ps -a, docker logs --tail 200 web, docker container inspect web, docker stats --no-stream — и, только если вы это разрешите, применяет исправления, например перезапуск указанного контейнера. Он читает те же STATUS200_URL, STATUS200_SERVICE_TOKEN и DOCKER_HOST_NAME, что и коллектор, поэтому обслуживает ровно этот хост и появляется на странице хоста ИИ-агент в Status200.

• ИИ-расследования включены по умолчанию. Как только агент подключается, Status200 AI расследует с его помощью инциденты и оповещения на этом хосте, а страница Обзор хоста показывает статус агента. Чтобы отключить это, задайте STATUS200_AI_INVESTIGATION=false там, где работает агент (как это сделать, показывает Изменить в разделе Что может делать ИИ на странице ИИ-агента), или не устанавливайте агента.
• Он работает только для чтения, если вы не запустите его с STATUS200_AI_ALLOW_WRITES=true; STATUS200_AI_WRITE_TARGETS (например, web-*,api-*) ограничивает, какие контейнеры может затрагивать исправление. Запустите его также с STATUS200_AI_FIXES, чтобы задать, как выполняются исправления, — ask-for-approval (каждое одобряет человек), automatic или bypass-approval, — а страница ИИ-агента покажет это только для чтения (Что может делать ИИ, задаётся агентом).
• Он работает от root со смонтированным сокетом Docker, потому что сокет принадлежит root, — а тот, кто может пользоваться сокетом, является root на этом хосте, с :ro или без. Границу задаёт политика команд агента: он никогда не выполняет exec, run, rm или prune и никогда не изменяет себя, коллектор или что-либо из STATUS200_AI_PROTECTED_TARGETS (glob-шаблоны имён контейнеров). Значения окружения в выводе docker inspect маскируются до того, как что-либо покинет хост.
• install.sh --no-ai-agent не устанавливает его; docker rm -f status200-docker-ai-agent удаляет его. Обновляйте его так же, как коллектор: docker pull status200/resource-ai-agent:release, удалите и запустите снова.

Что он может запускать, как работают исправления и как устранять неполадки: Infrastructure AI Agents.

Устранение неполадок#

Error: cannot start pipelines: failed to start "docker_stats" receiver:
Error response from daemon: client version 1.44 is too new.
Maximum supported API version is 1.41

docker version --format '{{ .Server.APIVersion }}'

docker run -d ... -e DOCKER_API_VERSION= ...

docker logs status200-docker-agent 2>&1 | grep -E "Started watching file|no files match"
docker inspect <container> --format '{{.HostConfig.LogConfig.Type}}'

docker inspect status200-docker-agent --format '{{range .Config.Env}}{{println .}}{{end}}' | grep DOCKER_HOST_NAME

Дальнейшие шаги#