Visualizing Yandex Monitoring data

This scenario will be useful if you have already deployed and started one of the Yandex Cloud services.

You will create a chart using the Yandex Monitoring query language and add it to the dashboard.

To visualize and explore data, set up DataLens and follow the steps below:

1. Create a connection.
2. Create a QL chart.
3. Create a dashboard.
4. Add the QL chart to the dashboard.
5. Add selectors to the dashboard.

Getting startedGetting started

To get started with DataLens:

1. Log in to your Yandex account.

2. Open the DataLens home page.

3. Click Open Datalens.

4. Select one of these options:

   • If you already have an organization, select it from the drop-down menu in the Organizations tab and click Open DataLens.

     Note

     To activate a DataLens instance, the user must have the admin or owner role. For more information about roles, see Access management in Yandex Cloud Organization.

   • If you have a cloud but no organization, click Add new DataLens. In the window that opens, enter a name and description for your organization and click Create organization and DataLens. For more information about working with organizations, see Getting started with organizations.

   If you encounter a technical issue with the service, contact Yandex Cloud support. To ask for advice, discuss a solution to your issue, or explore current best practices, join the DataLens chat in Telegram.

Create a connectionCreate a connection

Connecting to MonitoringConnecting to Monitoring

To create a Monitoring connection:

1. Go to the connections page.

2. Click Create connection.

3. Select a Monitoring connection.

4. Specify the connection settings:

   • Cloud and folder: Select the folder with your service account.
   • Service account: Select an existing service account or create a new one.

5. Click Create connection.

6. Enter a name for the connection and click Create. The connection will appear in the list.

Create a QL chartCreate a QL chart

1. Go to the connection you created.

2. In the top-right corner, click Create QL chart.

3. On the Query tab, enter the query text. You can either write it yourself or copy it from Monitoring.

   How to copy a query from Monitoring

   1. Go to the dashboard you need in Monitoring. To make your dashboards accessible, you need to have at least one of the Yandex Cloud services running.

   2. Open the chart you need in Metric Explorer by clicking in the top-right corner of the chart.

      

   3. At the bottom of the screen, go to the Queries tab.

   4. In the row with the query, click and select Copy as text. In DataLens, enter the query, skipping the folderId parameter.

      Example of a query in Monitoring:

      "cpu_usage"{folderId="b1g9r5h41935********", service="compute", resource_id="charts-prod-vla-1"}
      

      In DataLens, enter the query, skipping the folderId parameter:

      "cpu_usage"{service="compute", resource_id="charts-prod-vla-1"}
      

4. On the Parameters tab, specify the time interval.

   

5. Click Start. Check that the query runs without errors and the chart displays the data.

6. In the top-right corner, click Save.

7. Enter Monitoring Data Chart for the chart name and click Save.

You can add the chart to the dashboard. You can also add a selector to the dashboard to manage the interval parameter in the QL chart.

Create a dashboardCreate a dashboard

Create a dashboard for the charts.

1. Go to the DataLens home page.

2. Click Create dashboard.

   

Add the QL chart to the dashboardAdd the QL chart to the dashboard

1. At the top of the page, click Add and select Chart.

   

2. In the Chart field, click Select and select the chart you created in the previous steps, Monitoring Data Chart, from the chart list.

   

   Click Add.

3. The chart is now on the dashboard. Expand it for better visualization.

4. Save the dashboard:

   1. In the top-right corner, click Save.
   2. Enter Monitoring Data for the dashboard name and click Create.

Add selectors to the dashboardAdd selectors to the dashboard

Add a selector so that you can select the time range for the displayed data.

1. At the top of the page, click Add.

2. Choose Selector.

   

3. Select Manual input as the source type.

4. Under Field or parameter name, enter interval. This query variable will get the selected values from the selector.

5. Select Calendar as the selector type.

6. Enable Range.

   

7. In the Default value field, specify an offset from the current date and click Apply.

   

8. Enable Name and enter Date interval.

9. Click Add.

10. Place the selector on the dashboard above the chart.

11. Save the dashboard.

12. Your dashboard is now ready for use and you can select the time range with the selector.

    

See alsoSee also

• Adding a chart to a dashboard
• Adding a selector to a dashboard
• Creating a QL chart
• QL charts