[Документация Yandex Cloud](../index.md) > [Yandex Cloud Logging](index.md) > Начало работы # Начало работы с Cloud Logging {% note warning %} Сервис Cloud Logging будет закрыт во II квартале 2027 года, используйте вместо него Observability-платформу [Monium](../monium/index.md). {% endnote %} В этой инструкции вы добавите записи в [лог-группу](concepts/log-group.md), а после посмотрите их. ## Перед началом работы {#before-you-begin} Чтобы начать работать в Yandex Cloud: 1. Войдите в [консоль управления](https://kz.console.yandex.cloud). Если вы еще не зарегистрированы, перейдите в консоль управления и следуйте инструкциям. 1. На странице [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing) убедитесь, что у вас подключен [платежный аккаунт](../billing/concepts/billing-account.md), и он находится в статусе `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../billing/quickstart/index.md#create_billing_account). 1. Если у вас еще нет каталога, [создайте его](../resource-manager/operations/folder/create.md). ## Добавьте записи в лог-группу {% list tabs group=instructions %} - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. Чтобы добавить записи в лог-группу, выполните команду: * Linux, MacOS: ```bash yc logging write \ --group-name=default \ --message="My message" \ --level=INFO \ --json-payload='{"request_id": "1234"}' ``` * Windows (cmd): ```cmd yc logging write ^ --group-name=default ^ --message="My message" ^ --level=INFO ^ --json-payload="{"request_id": "1234"}" ``` * Windows (PowerShell): ```powershell yc logging write ` --group-name=default ` --message="My message" ` --level=INFO ` --json-payload='"{ \"request_id\": \"1234\" }"' ``` Где: * `--group-name` — имя лог-группы, в которую вы хотите добавить записи. Если параметр не указан, записи добавляются в [лог-группу по умолчанию](concepts/log-group.md) текущего каталога. Вместо `--group-name` можно указать `--group-id` — идентификатор группы. * `--message` — сообщение. * `--level` — уровень логирования. * `--json-payload` — дополнительная информация в формате JSON. Параметры `--group-name`, `--message`, `--json-payload` можно опустить и указать только значения параметров, соблюдая порядок. Например: `default "My message" '{"request_id": "1234"}'`. {% note info %} Возможна задержка появления записей в лог-группе до 60 секунд, поскольку системе требуется время на их обработку. {% endnote %} - API {#api} Чтобы добавить записи в лог-группу, воспользуйтесь вызовом gRPC API [LogIngestionService/Write](api-ref/grpc/LogIngestion/write.md). {% endlist %} ## Посмотрите записи Время в журнале указано по [UTC](https://ru.wikipedia.org/wiki/Всемирное_координированное_время). Записи можно отфильтровать с помощью [языка фильтрующих выражений](concepts/filter.md). {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) перейдите в каталог, в котором находится лог-группа. 1. Перейдите в сервис **Cloud Logging**. 1. Нажмите на строку с лог-группой, записи в которой хотите посмотреть. 1. На открывшейся странице отобразятся записи. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. При просмотре журнала вы можете указать конкретный временной интервал с помощью параметров `--since` и `--until`. Если временной интервал не был указан, отображается информация за последний час. Использование параметров: * `--since` — момент времени N и позже (параметр `--since` можно опустить и указать сразу время). * `--until` — момент времени N и раньше. Если был указан только один параметр, отображается информация за один час до или после момента времени N в зависимости от указанного параметра. Допустимые форматы указания времени: * `ЧЧ:ММ:СС`. Например, `15:04:05`. * [RFC-3339](https://www.ietf.org/rfc/rfc3339.txt). Например: `2006-01-02T15:04:05Z`, `2h`, `3h30m ago`. Для обращения к лог-группе используйте ее имя или уникальный идентификатор. Чтобы узнать их, [получите](operations/list.md) список лог-групп в каталоге. Если имя или идентификатор не указаны, выводятся записи из [лог-группы по умолчанию](concepts/log-group.md) текущего каталога. Параметры `--group-name` и `--group-id` можно опустить и указать сразу имя или идентификатор группы. Ограничить количество выводимых записей можно с помощью параметра `--limit`. Допустимые значения — от 1 до 1000. Чтобы посмотреть записи в формате JSON, выполните команду: ```bash yc logging read --group-name=default --format=json ``` Результат: ```text [ { "uid": "488ece3c-75b8-4d35-95ac-2b49********", "resource": {}, "timestamp": "2023-06-22T02:10:40Z", "ingested_at": "2023-06-22T08:49:15.716Z", "saved_at": "2023-06-22T08:49:16.176097Z", "level": "INFO", "message": "My message", "json_payload": { "request_id": "1234" } } ] ``` Чтобы читать записи по мере их поступления, используйте флаг `--follow`: ```bash yc logging read --group-name=default --follow ``` Такая команда выведет записи за последний час и продолжит выводить новые до тех пор, пока вы не прервете ее, нажав **Ctrl** + **C**. Флаг `--follow` не совместим с параметрами `--since` и `--until`. - SDK {#sdk} Читать записи в Cloud Logging можно с помощью [Yandex Cloud SDK](../overview/sdk/quickstart.md), реализованного для различных языков. Ниже приведены примеры использования Python SDK. Вы можете работать с кодом в своей инфраструктуре или в [Yandex Cloud Functions](../functions/index.md). **Локально** ```python import os import yandexcloud import pprint from yandex.cloud.logging.v1.log_reading_service_pb2 import ReadRequest from yandex.cloud.logging.v1.log_reading_service_pb2 import Criteria from yandex.cloud.logging.v1.log_reading_service_pb2_grpc import LogReadingServiceStub def handler(): cloud_logging_service = yandexcloud.SDK(iam_token=os.environ['iam']).client(LogReadingServiceStub) logs = {} criteria = Criteria(log_group_id='', resource_ids=['']) read_request = ReadRequest(criteria=criteria) logs = cloud_logging_service.Read(read_request) return logs pprint.pprint(handler()) ``` Где: * `log_group_id` — идентификатор [лог-группы](concepts/log-group.md). * `resource_ids` — идентификатор ресурса, например [кластера](../managed-kubernetes/concepts/index.md#kubernetes-cluster) Managed Service for Kubernetes. **Yandex Cloud Functions** ```python import yandexcloud from yandex.cloud.logging.v1.log_reading_service_pb2 import ReadRequest from yandex.cloud.logging.v1.log_reading_service_pb2 import Criteria from yandex.cloud.logging.v1.log_reading_service_pb2_grpc import LogReadingServiceStub def handler(event, context): cloud_logging_service = yandexcloud.SDK().client(LogReadingServiceStub) logs = {} criteria = Criteria(log_group_id='', resource_ids=['']) read_request = ReadRequest(criteria=criteria) logs = cloud_logging_service.Read(read_request) return logs ``` Где: * `log_group_id` — идентификатор [лог-группы](concepts/log-group.md). * `resource_ids` — идентификатор ресурса, например [кластера](../managed-kubernetes/concepts/index.md#kubernetes-cluster) Managed Service for Kubernetes. Параметры функции: * **Среда выполнения**: `python38`. * **Точка входа**: `index.handler`. * **Таймаут**: `3`. * **Память**: `128 МБ`. - API {#api} Чтобы посмотреть записи [в лог-группе](concepts/log-group.md), воспользуйтесь вызовом gRPC API [LogReadingService/Read](api-ref/grpc/LogReading/read.md). **Пример** Чтобы посмотреть записи в лог-группе за последний час с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl), выполните действия: 1. Получите и запишите IAM-токен в переменную: ```bash IAM_TOKEN=`yc iam create-token` ``` 1. Вычислите и запишите временны́е метки в переменные: ```bash NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ") ONE_HOUR_AGO=$(date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ") ``` Вы можете указать другой период вместо 1 часа — `"1 hour ago"`. Например, интервал `1 месяц, 2 недели, 3 дня и 4 часа` будет выглядеть так: ```text "1 month ago 2 weeks ago 3 days ago 4 hours ago" ``` {% cut "macOS" %} Для macOS используйте: ```bash NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ") ONE_HOUR_AGO=$(date -u -v-1H +"%Y-%m-%dT%H:%M:%SZ") ``` {% endcut %} 1. Запишите идентификатор нужной лог-группы в переменную: ```bash LOG_GROUP_ID="<идентификатор_лог-группы>" ``` 1. Выполните запрос с помощью gRPCurl: ```bash grpcurl -H "Authorization: Bearer $IAM_TOKEN" \ -d '{ "criteria": { "log_group_id": "'$LOG_GROUP_ID'", "since": "'$ONE_HOUR_AGO'", "until": "'$NOW'", "page_size": 10 } }' \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/logging/v1/log_reading_service.proto \ reader.logging.yandexcloud.kz:443 \ yandex.cloud.logging.v1.LogReadingService/Read ``` Где: * `log_group_id` — идентификатор лог-группы. * `since` — начало периода. * `until` — конец периода. * `page_size` — количество записей в результате. Результат: ```text { "logGroupId": "e23hf37rnj71********", "entries": [ { "uid": "26:10******:*", "resource": {}, "timestamp": "2025-05-22T14:42:12.896587Z", "ingestedAt": "2025-05-22T14:42:14.098Z", "savedAt": "2025-05-22T14:42:15.697585Z", "level": "INFO", "message": "test_message", "jsonPayload": { "host": "test_host", "request_id": "1234" } }, ... { "uid": "7:1a******:*", "resource": {}, "timestamp": "2025-05-22T14:42:25.864347Z", "ingestedAt": "2025-05-22T14:42:27.019Z", "savedAt": "2025-05-22T14:42:28.575509Z", "level": "INFO", "message": "test_message", "jsonPayload": { "host": "test_host", "request_id": "1234" } } ], "nextPageToken": "KLUv..." } ``` {% endlist %}