Создание лог-группы

Статья создана

Примечание

Имя лог-группы по умолчанию — default. Она создается автоматически, когда сервис или приложение пишет логи, указав в качестве назначения идентификатор каталога. Вы можете самостоятельно создать лог-группу с именем default. Тогда она будет лог-группой по умолчанию для того каталога, в котором ее создали.

Консоль управления

CLI

API

Terraform

В консоли управления перейдите в каталог, в котором хотите создать лог-группу.
Выберите сервис Cloud Logging.
Нажмите кнопку Создать группу.
(опционально) Введите имя и описание лог-группы. Формат имени:
- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.
Укажите срок хранения записей в лог-группе.
Нажмите кнопку Создать группу.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Примечание

Срок хранения записей можно указать только в часах, минутах или секундах. Например, 1h или 1440m.

Чтобы создать лог-группу, выполните команду:

yc logging group create \
  --name=group \
  --retention-period=1h \
  --data-stream=<идентификатор_потока>

Где:

--name — имя лог-группы.
--retention-period — срок хранения записей в лог-группе. Необязательный параметр. По умолчанию срок хранения записей — 3 дня.
data-stream — идентификатор потока данных Yandex Data Streams. Необязательный параметр. В указанный поток автоматически будут перенаправляться записи, которые добавили в лог-группу. Идентификатор потока состоит из зоны доступности, идентификатора каталога, идентификатора базы данных Yandex Managed Service for YDB и имени потока.
Например, укажите идентификатор потока /ru-central1/aoeu1kuk2dhtaupdb1es/cc8029jgtuabequtgtbv/aws_stream, если:
- aws_stream — имя потока;
- ru-central1 — зона доступности;
- aoeu1kuk2dhtaupdb1es — идентификатор каталога;
- cc8029jgtuabequtgtbv — идентификатор базы данных Yandex Managed Service for YDB.

Результат:

done (1s)
id: af3flf29t8**********
folder_id: aoek6qrs8t**********
cloud_id: aoegtvhtp8**********
created_at: "2021-06-24T09:56:38.970Z"
name: group
status: ACTIVE
retention_period: 3600s
data_stream: /ru-central1/aoeu1kuk2dhtaupdb1es/cc8029jgtuabequtgtbv/aws_stream

Создать пользовательскую лог-группу можно с помощью метода API create.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). Terraform и его провайдеры распространяются под лицензией Mozilla Public License.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Если у вас ещё нет Terraform, установите его и настройте провайдер Yandex Cloud.

Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:
- name — имя лог-группы. Необязательный параметр. Формат имени:
  - Длина — от 3 до 63 символов.
  - Может содержать строчные буквы латинского алфавита, цифры и дефисы.
  - Первый символ — буква. Последний символ — не дефис.
- folder_id — идентификатор каталога. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера.
- retention_period — срок хранения записей в лог-группе. Необязательный параметр. По умолчанию срок хранения записей — 3 дня.
Пример структуры конфигурационного файла:
```
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, см. в документации провайдера.
Проверьте корректность конфигурационных файлов.
1. В командной строке перейдите в папку, где вы создали конфигурационный файл.
2. Выполните проверку с помощью команды:
```
terraform plan
```
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
Разверните облачные ресурсы.
1. Если в конфигурации нет ошибок, выполните команду:
```
terraform apply
```
2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления или с помощью команды CLI:
```
yc logging group list
```

Создание лог-группы

Была ли статья полезна?