Создать лог-группу
-
В консоли управления
перейдите в каталог, в котором хотите создать лог-группу. -
Выберите сервис Cloud Logging.
-
Нажмите кнопку Создать группу.
-
(Опционально) Введите имя и описание лог-группы. Формат имени:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
Укажите срок хранения записей в лог-группе.
-
(Опционально) Выберите поток данных или создайте новый, чтобы перенаправлять в него записи, которые добавили в лог-группу.
-
Нажмите кнопку Создать группу.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы создать лог-группу, выполните команду:
yc logging group create \
--name=group \
--retention-period=1h \
--data-stream=<идентификатор_потока>
Где:
-
--name
— имя лог-группы. -
--retention-period
— срок хранения записей в лог-группе. Необязательный параметр.Срок хранения записей можно указать только в часах, минутах или секундах. Например,
1h
или1440m
. -
--data-stream
— идентификатор потока данных Yandex Data Streams. Необязательный параметр. В указанный поток автоматически будут перенаправляться записи, которые добавили в лог-группу. Идентификатор потока состоит из зоны доступности, идентификатора каталога, идентификатора базы данных Yandex Managed Service for YDB и имени потока.Например, укажите идентификатор потока
/ru-central1/aoeu1kuk2dht********/cc8029jgtuab********/aws_stream
, если:aws_stream
— имя потока;ru-central1
— зона доступности;aoeu1kuk2dht********
— идентификатор каталога;cc8029jgtuab********
— идентификатор базы данных Yandex Managed Service for YDB.
Результат:
done (1s)
id: af3flf29t8**********
folder_id: aoek6qrs8t**********
cloud_id: aoegtvhtp8**********
created_at: "2023-06-24T09:56:38.970Z"
name: group
status: ACTIVE
retention_period: 3600s
data_stream: /ru-central1/aoeu1kuk2dht********/cc8029jgtuab********/aws_stream
Terraform
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:
-
name
— имя лог-группы. Необязательный параметр. Формат имени:- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
folder_id
— идентификатор каталога. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера. -
retention_period
— срок хранения записей в лог-группе. Необязательный параметр.Срок хранения записей можно указать только в часах, минутах или секундах. Например,
1h
или1440m
.
Пример структуры конфигурационного файла:
provider "yandex" { token = "<OAuth-токен>" cloud_id = "<идентификатор_облака>" folder_id = "<идентификатор_каталога>" zone = "ru-central1-a" } resource "yandex_logging_group" "group1" { name = "<имя_лог-группы>" folder_id = "<идентификатор_каталога>" retention_period = "5h" }
Более подробную информацию о параметрах ресурса
yandex_logging_group
в Terraform, см. в документации провайдера . -
-
Проверьте корректность конфигурационных файлов.
-
В командной строке перейдите в папку, где вы создали конфигурационный файл.
-
Выполните проверку с помощью команды:
terraform plan
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
-
-
Разверните облачные ресурсы.
-
Если в конфигурации нет ошибок, выполните команду:
terraform apply
-
Подтвердите создание ресурсов: введите в терминал слово
yes
и нажмите Enter.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления
или с помощью команды CLI:yc logging group list
-
Чтобы создать лог-группу, воспользуйтесь методом REST API create для ресурса LogGroup или вызовом gRPC API LogGroupService/Create.
Пример запроса
Пример использования написан с помощью утилиты grpcurl
. Чтобы воспользоваться им, аутентифицируйтесь в API и клонируйте репозиторий cloudapi
Создайте файл payload.json
:
{
"folder_id": "<идентификатор_каталога>",
"name": "new-group",
"description": "Описание лог-группы, созданной с помощью grpcurl",
"labels": {
"compute": "instance-logging"
}
}
Выполните запрос:
grpcurl -rpc-header "Authorization: Bearer $(yc iam create-token)" \
-d @ \
-import-path ~/cloudapi/ \
-import-path ~/cloudapi/third_party/googleapis/ \
-proto ~/cloudapi/yandex/cloud/logging/v1/log_group_service.proto \
logging.api.cloud.yandex.net:443 yandex.cloud.logging.v1.LogGroupService.Create < payload.json
Ответ:
{
"id": "e23nitus5cg9********",
"description": "Create log group",
"createdAt": "2023-11-23T14:54:23.077532292Z",
"createdBy": "ajeugsk5ubk6********",
"modifiedAt": "2023-11-23T14:54:23.077532292Z",
"metadata": {
"@type": "type.googleapis.com/yandex.cloud.logging.v1.CreateLogGroupMetadata",
"logGroupId": "e23pjn86385t********"
}
}