yandex-cloud-monitoring-metrics

yandex-cloud-monitoring-metrics

A library for sending metrics to yandex cloud monitoring.

API doc https://cloud.yandex.com/en/docs/monitoring/operations/metric/add.

Supported metric types

• DGAUGE: shows the metric value at a certain point in time. For example, the amount of used RAM.
• GAUGE: shows the metric value at a certain point in time.
• COUNTER: shows the metric value that increases over time. For example, the number of days of service continuous running.
• RATE: shows the change in the metric value over time. For example, the number of requests per second.

Getting started

• Get the ID of the folder for which you are granted the monitoring.editor role or a higher role (https://cloud.yandex.com/en/docs/resource-manager/operations/folder/get-id)
• Create a service account https://cloud.yandex.com/en-ru/docs/iam/concepts/users/service-accounts with monitoring.writer permission
• Store the service account ID, access key ID and private key

Install

npm install yandex-cloud-monitoring-metrics

Usage

const metricsLogger = new YandexCloudMonitoringMetricsLogger(
  process.env.SERVICE_ACCOUNT_ID,
  process.env.ACCESS_KEY_ID,
  process.env.PRIVATE_KEY,
  process.env.FOLDER_ID
);

const metrics: IYandexMetricRequest = {
  metrics: [
    {
      name: 'performance.metric',
      type: YandexMetricType.GAUGE,
      value: 150,
      labels: {
        env: 'production',
        tag1: 'value1',
      },
    },
  ],
};

const { writtenMetricsCount, error } = await metricsLogger.writeMetrics(
  metrics
);