[Документация Yandex Cloud](../../../index.md) > [Monium](../../index.md) > Метрики > [Поставка и экспорт метрик](../index.md) > Запись пользовательских метрик через API

# Запись пользовательских метрик через API

Чтобы начать записывать пользовательские метрики через API, воспользуйтесь методом [write](../../api-ref/MetricsData/write.md).

### Перед началом работы {#before-you-begin}

Чтобы воспользоваться примерами в этом разделе:

1. Убедитесь, что у вас установлена утилита [cURL](https://curl.haxx.se), используемая в примерах.
1. [Получите идентификатор каталога](../../../resource-manager/operations/folder/get-id.md), на который у вас есть роль `monitoring.editor` или выше.
1. Получите IAM-токен:

   * [Инструкция](../../../iam/operations/iam-token/create.md) для пользователя с аккаунтом на Яндексе.
   * [Инструкция](../../../iam/operations/iam-token/create-for-sa.md) для сервисного аккаунта.
   * [Инструкция](../../../iam/operations/iam-token/create-for-federation.md) для федеративного аккаунта.
   * [Инструкция](../../../iam/operations/iam-token/create-for-local.md) для локального аккаунта.

### Пример запроса {#sample-request}

1. Создайте файл с телом запроса, например `body.json`. В свойстве `metrics` перечислите список метрик для записи. Обязательные метки передаются в query-параметрах запроса, а дополнительные — в теле запроса.

    **body.json:**
    ```json
    {
        "metrics": [
            {
                "name": "temperature",
                "labels": {
                    "building": "office",
                    "room": "openspace"
                },
                "value": 18.6
            }
        ]
    }
    ```

1. Отправьте запрос и сохраните ответ в файл, например `output.json`:

    ```bash
    export IAM_TOKEN=CggaATEVAgA...
    curl \
      --request POST \
      --header "Content-Type: application/json" \
      --header "Authorization: Bearer ${IAM_TOKEN}" \
      --data '@body.json' \
      'https://monitoring.api.yandexcloud.kz/monitoring/v2/data/write?folderId=aoe6vrq0g3sv********&service=custom' > output.json
    ```

    Пример ответа на запрос:

    **output.json:**
    ```json
    {
        "metrics_written":"1"
    }
    ```