Получить логи

к сведению

Получить логи можно только для балансировщиков и кластеров облачных баз данных, для которых включено логирование.

Вы можете:

получать список групп логов;
получать список стримов событий;
получать события.

Получать логи можно с помощью:

панели управления;
методов Cloud Logging API. Авторизоваться можно с помощью IAM-токена для проекта, который передается в каждом запросе в заголовке X-Auth-Token, или S3-ключа;
интерфейса AWS CLI, который имплементирует методы Amazon CloudWatch API, подробнее в документации AWS (DescribeLogGroups, DescribeLogStreams и GetLogEvents). Для начала работы настройте его;
плагина Fluent Bit.

Адрес (URL) можно посмотреть в списке URL.

Получить список групп логов⁠

Панель управления
API
AWS CLI

В панели управления в верхнем меню нажмите Продукты и выберите Логи.
Перейдите в раздел Логи.
Выберите регион и пул.

Выполните запрос:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<pool>.logs.selcloud.ru/v1/groups?limit=50'

Укажите:

<x_auth_token> — IAM-токен для проекта;
<pool> — пул, в котором находятся логи, например ru-8. Адрес (URL) зависит от региона и пула, можно посмотреть в списке URL.

Если групп логов нет, вы получите ответ:

{"groups":[]}

Если группы логов есть, вы получите ответ в виде списка в формате JSON. Пример ответа:

{
    "groups": [
        {
            "name": "s/lbaas/Bellatrix-lb",
            "created_at": 1742663023757
        },
        {
            "name": "group-name",
            "created_at": 1738779717218
        },
        {
            "name": "s/lbaas/test-lb-for-logs",
            "created_at": 1743073180613
        }
    ]
}

Выполните команду:

aws logs describe-log-groups

Получить список стримов событий⁠

Панель управления
API
AWS CLI

В панели управления в верхнем меню нажмите Продукты и выберите Логи.
Перейдите в раздел Логи.
Выберите регион и пул.
Опционально: выберите продукт группы логов.
Перейдите на страницу группы логов.

Выполните запрос:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<pool>.logs.selcloud.ru/v1/streams?group=<log_group_name>&sort=asc'

Укажите:

<x_auth_token> — IAM-токен для проекта;
<pool> — пул, в котором находятся логи, например ru-8. Адрес (URL) зависит от региона и пула, можно посмотреть в списке URL;
<log_group_name> — имя группы логов, например s/lbaas/Bellatrix-lb.

Пример ответа:

{"streams":[{"name":"http-b964dde5-7080-4169-8f9e-127bd59c89ca","created_at":1742663023793}]}

Выполните команду:

aws logs describe-log-streams --log-group-name <log_group_name>

Укажите <log_group_name> — имя группы логов, например s/lbaas/Bellatrix-lb.

Получить события⁠

Панель управления
API
AWS CLI

В панели управления в верхнем меню нажмите Продукты и выберите Логи.
Перейдите в раздел Логи.
Выберите регион и пул.
Опционально: выберите продукт группы логов.
Перейдите на страницу группы логов.
Выберите стрим.
В поисковую строку введите значение, которое должны содержать события. Вы можете использовать паттерн фильтров для неструктурированных логов. Подробнее в инструкции Using filter patterns to match terms in unstructured log events документации AWS.

Примеры значений в поисковой строке и результаты поиска по паттерну фильтра:
- error — выведутся события, которые содержат error;
- error timeout — выведутся события, которые содержат error и timeout;
- ?500 ?404 — выведутся события, которые содержат 500 или 404;
- error -timeout — выведутся события, которые содержат error, но не содержат timeout;
- "internal server error" — выведутся события с точным совпадением значения.
Опционально: выберите Время UTC или Локальное время для отображаемого времени событий.
Укажите период времени, чтобы отфильтровать события.

Пример запроса для получения 10 событий:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<pool>.logs.selcloud.ru/v1/events?group=<log_group_name>&stream=<stream_name>&sort=desc&limit=10'

Укажите:

<x_auth_token> — IAM-токен для проекта;
<pool> — пул, в котором находятся логи, например ru-8. Адрес (URL) зависит от региона и пула, можно посмотреть в списке URL;
<log_group_name> — имя группы логов, например s/lbaas/Bellatrix-lb;
<stream_name> — имя стрима событий, например http-b964dde5-7080-4169-8f9e-127bd59c89ca.

Пример ответа:

{
    "events": [
        {
            "id": "6b050a98-8810-4832-b0fe-aee56e34b682",
            "ingestion": 1742920694862,
            "message": "{\"loadbalancer_id\":\"b964dde5-7080-4169-8f9e-127bd59c89ca\",\"client\":\"10.10.10.10:61076\",\"server_queue\":\"0\",\"backend\":\"0c7498bf-e053-43a8-ba19-4550c9d9904d:3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"bytes_out\":\"354\",\"backend_connections\":\"0\",\"destination\":\"192.168.0.18:80\",\"bytest_in\":\"991\",\"termination_state\":\"--\",\"server\":\"ac64ca54-952f-4881-8a54-6ff77baa1e91\",\"frontend_connections\":\"1\",\"backend_queue\":\"0\",\"elapsed\":\"4\",\"frontend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"server_connections\":\"0\"}",
            "timestamp": 1742920687071
        },
        {
            "id": "687feab8-6eb9-4ef1-95ed-92259b6bce4a",
            "ingestion": 1742920697233,
            "message": "{\"loadbalancer_id\":\"b964dde5-7080-4169-8f9e-127bd59c89ca\",\"client\":\"10.10.10.10:61076\",\"server_queue\":\"0\",\"backend\":\"0c7498bf-e053-43a8-ba19-4550c9d9904d:3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"bytes_out\":\"413\",\"backend_connections\":\"0\",\"destination\":\"192.168.0.18:80\",\"bytest_in\":\"1039\",\"termination_state\":\"--\",\"server\":\"ac64ca54-952f-4881-8a54-6ff77baa1e91\",\"frontend_connections\":\"1\",\"backend_queue\":\"0\",\"elapsed\":\"9\",\"frontend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"server_connections\":\"0\"}",
            "timestamp": 1742920687061
        },
        {
            "id": "63a9fac7-f68e-4540-8419-55e9ef7d426f",
            "ingestion": 1742920615179,
            "message": "{\"loadbalancer_id\":\"b964dde5-7080-4169-8f9e-127bd59c89ca\",\"client\":\"10.10.10.10:61074\",\"server_queue\":\"0\",\"backend\":\"0c7498bf-e053-43a8-ba19-4550c9d9904d:3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"bytes_out\":\"78\",\"backend_connections\":\"0\",\"destination\":\"192.168.0.18:80\",\"bytest_in\":\"680\",\"termination_state\":\"--\",\"server\":\"ac64ca54-952f-4881-8a54-6ff77baa1e91\",\"frontend_connections\":\"1\",\"backend_queue\":\"0\",\"elapsed\":\"3\",\"frontend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"server_connections\":\"0\"}",
            "timestamp": 1742920605822
        },
        {
            "id": "a684a2c7-4d3a-4d78-8bdf-d61ab45ce723",
            "ingestion": 1742918217458,
            "message": "{\"loadbalancer_id\":\"b964dde5-7080-4169-8f9e-127bd59c89ca\",\"client\":\"10.10.10.10:54460\",\"server_queue\":\"0\",\"backend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"bytes_out\":\"0\",\"backend_connections\":\"0\",\"destination\":\"-:-\",\"bytest_in\":\"0\",\"termination_state\":\"CR\",\"server\":\"\u003cNOSRV\u003e\",\"frontend_connections\":\"2\",\"backend_queue\":\"0\",\"elapsed\":\"17\",\"frontend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"server_connections\":\"0\"}",
            "timestamp": 1742918210144
        },
        {
            "id": "d1bf4c22-dee0-424a-a6b5-933c3d2c19f2",
            "ingestion": 1742918217458,
            "message": "{\"loadbalancer_id\":\"b964dde5-7080-4169-8f9e-127bd59c89ca\",\"client\":\"10.10.10.10:54459\",\"server_queue\":\"0\",\"backend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"bytes_out\":\"0\",\"backend_connections\":\"0\",\"destination\":\"-:-\",\"bytest_in\":\"0\",\"termination_state\":\"CR\",\"server\":\"\u003cNOSRV\u003e\",\"frontend_connections\":\"2\",\"backend_queue\":\"0\",\"elapsed\":\"17\",\"frontend\":\"3ae8b472-d305-4ef0-8093-d43c87bc3646\",\"server_connections\":\"0\"}",
            "timestamp": 1742918210143
        }
    ],
    "pages": {
        "next": "1d1bf4c22dee0424aa6b5933c3d2c19f2174291821014300",
        "prev": "06b050a9888104832b0feaee56e34b682174292068707100"
    }
}

Выполните команду:

aws logs get-log-events --log-group-name  <log_group_name> --log-stream-name <stream_name>

Укажите:

<log_group_name> — имя группы логов, например s/lbaas/Bellatrix-lb;
<stream_name> — имя стрима событий, например http-b964dde5-7080-4169-8f9e-127bd59c89ca.

Получить список групп логов⁠​

Получить список стримов событий⁠​

Получить события⁠​

Получить список групп логов⁠

Получить список стримов событий⁠

Получить события⁠