Get started
Yandex Monitoring

Delivering Linux system metrics

Written by

    To deliver system metrics for virtual machines running on Linux-compatible operating systems to Yandex Monitoring, use the input linux_metrics.

    Warning

    Delivery of system metrics for virtual machines run on Windows and macOS is planned for upcoming Yandex Unified Agent releases.

    To configure Yandex Unified Agent to collect system metrics from a Yandex.Cloud VM, follow these steps:

    1. Set up a service account from which metrics will be written to Yandex Monitoring.

      1. Create a service account in the folder you want to write metrics to and assign it the monitoring.editor role.

      2. Link your service account to a virtual machine with Unified Agent installed.

    2. Install and configure Yandex Unified Agent.

      1. Install Unified Agent on your VM by running the following command in the home folder:

        docker run \
-p 16241:16241 -it --detach --uts=host \
--name=ua \
-v /proc:/ua_proc \
-v config.yml:/etc/yandex/unified_agent/conf.d/config.yml \
-e PROC_DIRECTORY=/ua_proc \
-e FOLDER_ID=a1bs... \
cr.yandex/yc/unified-agent

        You can find more ways to install the agent in Installing and running Yandex Unified Agent.

      2. Create a file named config.yml in your home folder. Replace $FOLDER_ID in the file with the ID of the folder you want to write metrics to.

        config.yml:

         status:
   port: "16241"

 storages:
   - name: main
     plugin: fs
     config:
       directory: /var/lib/yandex/unified_agent/main
       max_partition_size: 100mb
       max_segment_size: 10mb

 channels:
   - name: cloud_monitoring
     channel:
       pipe:
         - storage_ref:
             name: main
       output:
         plugin: yc_metrics
         config:
           folder_id: "$FOLDER_ID"
           iam:
             cloud_meta: {}

 routes:
   - input:
       plugin: linux_metrics
       config:
         namespace: sys
     channel:
       channel_ref:
         name: cloud_monitoring

   - input:
       plugin: agent_metrics
       config:
         namespace: ua
     channel:
       pipe:
         - filter:
             plugin: filter_metrics
             config:
               match: "{scope=health}"
       channel_ref:
         name: cloud_monitoring

 import:
   - /etc/yandex/unified_agent/conf.d/*.yml

    3. Make sure the metrics are delivered to Yandex Monitoring.

      1. On the Yandex Monitoring home page, go to Metric Explorer.

      2. In the query block, select:

      • The folder where metrics are collected.
      • The label value service=custom.
      • The metric name starting with the sys prefix.

    What's next