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

к сведению

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

Вы можете получить список групп логов, список стримов событий и события.

Получать логи можно:

через панель управления;
с помощью AWS CLI;
или SDK-клиента.

Вы можете также экспортировать логи в собственное хранилище с помощью плагина Fluent Bit и агента Grafana Alloy.

Адрес (URL) сервиса Логи в нужном пуле можно посмотреть в инструкции Список URL.

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

Панель управления
SDK-клиент
AWS CLI

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

к сведению

В сервисе не поддерживаются параметры logGroupClass, includeLinkedAccounts, accountIdentifiers и logGroupIdentifiers для получения списка групп логов. Подробнее о параметрах группы логов в инструкции DescribeLogGroups официальной документации AWS.

Python
Go

Откройте файл скрипта. Если у вас еще нет файла скрипта, создайте новый.
Добавьте скрипт для получения групп логов в файл:
```
response = client.describe_log_groups(
    # logGroupNamePrefix='<log_group_name_prefix>',
    # logGroupNamePattern='<log_group_name_pattern>',
    # nextToken='<next_token>',
    limit=<log_groups_number>,
)

print(response['logGroups'])
print(response.get('nextToken'))
```
Укажите:
- опционально: <log_group_name_prefix> — префикс группы логов, например s/lbaas/; Не указывайте параметр logGroupNamePrefix, если вы передали параметр logGroupNamePattern;
- опционально: <log_group_name_pattern> — шаблон имени группы логов для фильтрации. Параметр чувствителен к регистру. В ответе будут отображаться группы логов, имена которых совпадают с указанным значением. Например, если указать lbaas, в ответе будут отображаться группы логов с именами lbaas, s/lbaas. Не указывайте параметр logGroupNamePattern, если вы передали параметр logGroupNamePrefix;
- опционально: <next_token> — токен для следующего набора возвращаемых групп, который вы получили в ответе на прошлый запрос;
- <log_groups_number> — максимальное количество групп в ответе, например 10. Если значение не указано, по умолчанию будет возвращаться 50 групп. Если группы не найдены, вы получите пустой список. Пример ответа:

Запустите скрипт. В ответе вы получите:

пустой список, если группы логов нет. Пример ответа:
```
{"logGroups":[]}
```

список группы логов. Пример ответа:

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

список группы логов и nextToken, если есть еще группы. Вы можете использовать токен в запросе для получения следующей страницы результатов. Пример ответа:
```
{
    "logGroups": [...],
    "nextToken": 'string'
}
```

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

Панель управления
SDK-клиент
AWS CLI

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

к сведению

В сервисе не поддерживаются параметры logGroupIdentifier, descending и orderBy для получения списка стримов событий. Подробнее о параметрах стримов событий в инструкции DescribeLogStreams официальной документации AWS.

Python
Go

Откройте файл скрипта. Если у вас еще нет файла скрипта, создайте новый.
Добавьте скрипт для получения стримов событий в файл:
```
response = client.describe_log_streams(
    logGroupName='<log_group_name>',
    # nextToken='<next_token>',
    limit=<streams_number>,
)

print(response['logGroups'])
print(response.get('nextToken'))
```
Укажите:
- <log_group_name> — имя группы логов, например s/lbaas/Bellatrix-lb;
- опционально: <next_token> — токен для следующего набора возвращаемых стримов, который вы получили в ответе на прошлый запрос;
- <streams_number> — максимальное количество стримов в ответе, например 10. Если значение не указано, по умолчанию будет возвращаться 50 стримов.
Запустите скрипт. В ответе вы получите:
- пустой список, если стримов в группе логов нет. Пример ответа:
```
{"logStreamName":[]}
```
- список стримов в группе логов. Пример ответа:
```
{
    "logStreamName": [
        {
            "logStreamName": "pgbouncer.log-2a682d5d-dea9-48bc-8850-0c332c574f4e", 
            "creationTime": 1755619440620
        },
        {
            "logGroupName": "stream-name",
            "creationTime": 1755619440634
        }
    ]
}
```
- список стримов и nextToken, если есть еще стримы. Вы можете использовать токен в запросе для получения следующей страницы результатов. Пример ответа:
```
{
    "logStreamName": [...],
    "nextToken": "string"
}
```

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

Панель управления
SDK-клиент
AWS CLI

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

к сведению

В сервисе не поддерживаются параметры logGroupIdentifier и unmask для получения событий. Подробнее о параметрах событий в инструкции GetLogEvents официальной документации AWS.

Python
Go

Откройте файл скрипта. Если у вас еще нет файла скрипта, создайте новый.
Добавьте скрипт для получения событий в файл:
```
response = client.get_log_events(
    logGroupName='<log_group_name>',
    logStreamName='<stream_name>',
    # nextBackwardToken='<back_token>',
    # nextForwardToken='<next_token>',
    limit=<events_number>
)

print(response)
```
Укажите:
- <log_group_name> — имя группы логов, например s/lbaas/Bellatrix-lb;
- <log_stream_name> — имя стрима событий, например http-b964dde5-7080-4169-8f9e-127bd59c89ca;
- опционально: <back_token> — токен для предыдущего набора возвращаемых событий, который вы получили в ответе на прошлый запрос;
- опционально: <next_token> — токен для следующего набора возвращаемых событий, который вы получили в ответе на прошлый запрос;
- <events_number> — максимальное количество событий логов в ответе. Минимальное значение событий в ответе — 1, максимальное значение — 10 000. Если ограничение не указано, в ответе по умолчанию отображается количество событий размером 1 МБ (до 10 000 событий).

Запустите скрипт. В ответе вы получите:

пустой список, если событий в стриме нет. Пример ответа:
```
{"events":[]}
```

список событий стрима. Пример ответа:

{
    "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
        }
    ]
}

список событий, nextBackwardToken или nextForwardToken, если есть еще события. Вы можете использовать токен в запросе для получения предыдущей или следующей страницы результатов. Пример ответа:
```
{
    "events": [...],
    "nextBackwardToken": "string",
    "nextForwardToken": "string"
}
```

Отфильтровать события

Панель управления
SDK-клиент
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 или Локальное время для отображаемого времени событий.
Укажите период времени, чтобы отфильтровать события.
Опционально: если логи собираются в JSON-формате, настройте табличное отображение полей в списке событий:

10.1. Нажмите .

10.2. Отметьте чекбоксы полей, значение которых нужно отобразить в виде таблицы.

10.3. Нажмите Подтвердить.