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

Работоспособность сервиса PBR-Agent

примечание

Исполнять сценарий необходимо от имени пользователя postgres.

Описание сценария​

Проверка пользователем возможности запуска сервиса PBR-Agent и доступности подключения к инфраструктуре CopyWala.

Последовательность выполнения​

Для проверки работоспособности PBR-Agent воспользуйтесь командой pbr-agent healthcheck.

Результат​

В результате выполнения команды будет выведено сообщение, которое отобразит статус работоспособности компонента PBR-Agent:

Log                      [OK]
Config                   [OK]
Agent ID                 [OK: 01956688-fda2-72ce-a4ae-bdc98a951828]
PBRA DB                  [OK]
Agent Manager            [OK]
________________________________________
Overall System           [OK]

Исключительные сценарии​

  • Если конфигурационный файл не будет найден, отобразится сообщение об ошибке загрузки файла: Error: open /etc/pbr/pbr-agent.yaml: no such file or directory.

  • В случае неудачной загрузки конфигурационного файла будет отображено сообщение об ошибке. Например, при ошибке валидации адреса для подключения к API Gateway:

    Error: Key: <'Config.api_gateway.http_address'>
    Error:Field validation for 'http_address' failed on the 'url' tag`

  • Если pbr-agent ранее уже инициализировал приложение и выполнил регистрацию, а затем повторно инициализировал приложение, то при попытке обращения к сервису появится предупреждение о расхождении идентификатора агентского приложения в токене и AppIdInfo в файле:

    $ pbr-agent healthcheck
    Application init         [OK]
    PBRA DB                  [OK]
    Instance name            [OK: agent_test]
    Agent ID                 [OK: 0198e1c7-87e5-7e0b-a4d0-355476c2353c]
    2025-08-26 10:50:07.214 ERR Agent registration (ID): token agent id mismatched with app agent id: 0198bc0d-7ff2-7d62-a43b-79f980412bd1 != 0198e1c7-87e5-7e0b-a4d0-355476c2353c: reestablish agent registration is required
    Agent registration (ID)  [FAILED]
    Agent Manager Heartbeat  [FAILED]
    2025-08-26 10:50:07.354 ERR Agent Manager Heartbeat err="Post \"https://<IP-Address>:29000/api/agent-manager/v1/agents/self/heartbeat\": http: server gave HTTP response to HTTPS client"
    2025-08-26 10:50:07.443 INF ws: connecting to ws://<IP-Address>:29000 package=clients.websocket
    2025-08-26 10:50:07.591 ERR ws: connect failed package=clients.websocket err="failed to WebSocket dial: expected handshake response status code 101 but got 502"
    2025-08-26 10:50:12.773 INF ws: connecting to ws://<IP-Address>:29000 package=clients.websocket
    2025-08-26 10:50:12.813 ERR ws: connect failed package=clients.websocket err="failed to WebSocket dial: failed to send handshake request: Get \"http://<IP-Address>:29000/ws/agents/connect\": context deadline exceeded"
    Agent Manager WebSocket  [FAILED]
    2025-08-26 10:50:12.951 ERR Agent Manager WebSocket err="context deadline exceeded"
    Copywala exists          [OK]
    Copywala health          [OK]
    ________________________________________
    Overall System           [FAILED]

  • Если агентское приложение не инициализировано, будет выведено предупреждение о необходимости провести его инициализацию:

    $ pbr-agent healthcheck
    Application init         [OK]
    PBRA DB                  [OK]
    2025-08-26 10:51:07.101 ERR app: load app id info failed err="app id is not initialized"
    Instance name            [FAILED]
    2025-08-26 10:51:07.342 ERR Instance name err="app id is not initialized"
    2025-08-26 10:51:07.389 ERR app: load app id info failed err="app id is not initialized"
    Agent registration (ID)  [FAILED]
    2025-08-26 10:51:07.563 ERR Agent registration (ID) err="app id is not initialized"
    Agent Manager Heartbeat  [FAILED]
    2025-08-26 10:51:07.647 ERR Agent Manager Heartbeat err="Post \"https://<IP-Address>:29000/api/agent-manager/v1/agents/self/heartbeat\": http: server gave HTTP response to HTTPS client"
    2025-08-26 10:51:07.715 INF ws: connecting to ws://<IP-Address>:29000 package=clients.websocket
    2025-08-26 10:51:07.774 ERR ws: connect failed package=clients.websocket err="failed to WebSocket dial: expected handshake response status code 101 but got 502"
    2025-08-26 10:51:12.893 INF ws: connecting to ws://<IP-Address>:29000 package=clients.websocket
    2025-08-26 10:51:12.914 ERR ws: connect failed package=clients.websocket err="failed to WebSocket dial: failed to send handshake request: Get \"http://<IP-Address>:29000/ws/agents/connect\": context deadline exceeded"
    Agent Manager WebSocket  [FAILED]
    2025-08-26 10:51:12.952 ERR Agent Manager WebSocket err="context deadline exceeded"
    Copywala exists          [OK]
    Copywala health          [OK]
    ________________________________________
    Overall System           [FAILED]