Инструменты для анализа производительности

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы посмотреть логи Yandex StoreDoc:

1. Посмотрите описание команды CLI для просмотра логов:

   yc managed-mongodb cluster list-logs --help
   

2. Для получения всех логов кластера выполните команду:

   yc managed-mongodb cluster list-logs --id <идентификатор_кластера>
   

   Идентификатор кластера можно получить со списком кластеров в каталоге.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом Cluster.ListLogs и выполните запрос, например, с помощью cURL:

   curl \
       --request GET \
       --header "Authorization: Bearer $IAM_TOKEN" \
       --url 'https://mdb.api.cloud.yandex.net/managed-mongodb/v1/clusters/<идентификатор_кластера>:logs' \
       --url-query serviceType=<тип_сервиса> \
       --url-query columnFilter=<список_колонок> \
       --url-query fromTime=<левая_граница_временного_диапазона> \
       --url-query toTime=<правая_граница_временного_диапазона>
   

   Где:

   • serviceType — тип сервиса, логи которого нужно получить:

     • MONGOD — лог операций Yandex StoreDoc.
     • AUDIT — лог аудита.

   • columnFilter — список колонок для вывода информации:

     • hostname — имя хоста.
     • component — тип компонента, который попадет в лог. Например, HTTP-Session.
     • message — сообщение, которое выводит компонент.
     • query_id — идентификатор запроса.
     • severity — уровень логирования, например, Debug.
     • thread — идентификатор потока, участвующего в обработке запросов.

     В одном параметре columnFilter можно указать только одну колонку. Если необходимо отфильтровать логи по нескольким колонкам, передайте перечень нужных колонок в нескольких параметрах.

     • fromTime — левая граница временного диапазона в формате RFC-3339. Пример: 2006-01-02T15:04:05Z.
     • toTime — правая граница временного диапазона, формат аналогичен fromTime.

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом ClusterService.ListLogs и выполните запрос, например, с помощью gRPCurl:

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/mongodb/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "service_type": "<тип_сервиса>",
           "column_filter": [
             "<колонка_1>", "<колонка_2>", ..., "<колонка_N>"
           ],
           "from_time": "<левая_граница_временного_диапазона>",
           "to_time": "<правая_граница_временного_диапазона>"
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.mongodb.v1.ClusterService.ListLogs
   

   Где:

   • service_type — тип сервиса, логи которого нужно получить:

     • MONGOD — лог операций Yandex StoreDoc.
     • AUDIT — лог аудита.

   • column_filter — список колонок для вывода информации:

     • hostname — имя хоста.
     • component — тип компонента, который попадет в лог. Например, HTTP-Session.
     • message — сообщение, которое выводит компонент.
     • query_id — идентификатор запроса.
     • severity — уровень логирования, например, Debug.
     • thread — идентификатор потока, участвующего в обработке запросов.

     В параметре column_filter можно указать несколько колонок, если нужно отфильтровать логи по нескольким колонкам.

     • from_time — левая граница временного диапазона в формате RFC-3339. Пример: 2006-01-02T15:04:05Z.
     • to_time — правая граница временного диапазона, формат аналогичен from_time.

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.