All Products
Search
Document Center

Simple Log Service:Send time series data from Simple Log Service to Grafana

Last Updated:Sep 02, 2024

Metricstores of Simple Log Service are compatible with the query API of Prometheus. This topic describes how to connect Simple Log Service as a Prometheus data source to Grafana. You can then send data from Simple Log Service to Grafana and visualize the data in Grafana.

Prerequisites

Configure Simple Log Service as a Prometheus data source in Grafana

  1. Log on to Grafana.

  2. In the left-side navigation pane, choose Configuration > Data Sources.

  3. On the Data Sources tab, click Add data source.

  4. Move the pointer over the Prometheus card and click Select.

  5. On the Settings tab, set the following parameters.

    Parameter or section

    Description

    Name

    Set a name for the data source, for example, Prometheus-01.

    HTTP

    • URL: Enter the URL of the Metricstore. Format: https://{project}.{sls-endpoint}/prometheus/{project}/{metricstore}. Replace {sls-endpoint} with the Simple Log Service endpoint in the region where the project resides. For the list of Simple Log Service endpoints in different regions, see Endpoints. Replace {project} and {metricstore} with the project name and Metricstore name. Example: https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/prometheus.

      Note

      To ensure secure transmission, use HTTPS.

    • Whitelisted Cookies: Specify a whitelist for access. This parameter is optional.

    Auth

    Select the Basic Auth check box.

    Basic Auth Details

    • User: Enter an AccessKey ID.

    • Password: Enter an AccessKey secret that corresponds to the AccessKey ID.

    We recommend that you use an AccessKey pair of a RAM user that has only the permissions to read data from the Simple Log Service project. For information about how to grant a RAM user only the permissions to read data from a specified Simple Log Service project, see The read-only permission on projects.

  6. Click Save & Test.

Import a Simple Log Service dashboard template to Grafana

Perform the following steps to import a Simple Log Service dashboard template to Grafana:

  1. Copy the template ID.

    1. Log on to the dashboard market of Grafana.

    2. Click the template.

    3. On the right side of the page, click Copy ID to Clipboard.

  2. Log on to Grafana.

  3. In the left-side navigation pane, choose Create > Import.

  4. In the Grafana.com Dashboard field, paste the template ID that you copied in Step 1.

    Then, click a blank area to go to the page for data source configuration.

  5. Configure the data source.

    In this step, set the parameters based on the data source that you added when you configure Simple Log Service as a Prometheus data source in Grafana. The parameters vary depending on the dashboard template. The parameters may include telegraf and host.

  6. Click Import.

Access Simple Log Service by using the query API of Prometheus

Simple Log Service is compatible with the query API of Prometheus. You can configure Simple Log Service as a Prometheus data source in Grafana or use the Prometheus API to access Simple Log Service. The following table provides examples of the supported API operations.

Operation

Example

Instant queries

GET /api/v1/query
POST /api/v1/query

Range queries

GET /api/v1/query_range
POST /api/v1/query_range

Getting label names

GET /api/v1/labels
POST /api/v1/labels

Querying label values

GET /api/v1/label/<label_name>/values

Finding series by label matchers

GET /api/v1/series
POST /api/v1/series