---
title: 'Grafana'
sidebar_label: 'Grafana'
description: 'Как настроить Grafana для визуального представления метрик и анализа данных'
sidebar_position: 4
---

import Formbricks from '@theme/MDXComponents/Formbricks';
import Tabs from '@theme/Tabs'
import TabItem from '@theme/TabItem'
import {TabItemLabel} from '@selectel/docux/components'
import CopyIcon from '@selectel/docux/icons/copy'

# Grafana

[Grafana](https://grafana.com/) — платформа с открытым исходным кодом для визуализации метрик и анализа данных в реальном времени.
Сервис Метрики поддерживает полную интеграцию с Grafana.
Интеграция позволяет просматривать исторические метрики за 30 дней и строить аналитические запросы к метрикам.

Для визуализации метрик [настройте Grafana](#configure-grafana).

## Настроить Grafana \{#configure-grafana}

1. [Добавьте сервисного пользователя](#add-service-user).
2. [Запустите Grafana](#start-grafana).
3. [Настройте источник данных](#configure-data-source).
4. [Создайте дашборд](#create-dashboard).

### 1. Добавить сервисного пользователя \{#add-service-user}

[Добавьте сервисного пользователя](/access-control/manage/add-user.mdx#add-service-user) с разрешением в области доступа **Проекты** и ролью:

* [`metrics.admin`](/metrics/manage-access.mdx#metrics-admin);
* [`member`](/access-control/role-reference.mdx#member);
* или [`reader`](/access-control/role-reference.mdx#reader).

Добавлять пользователей может [Владелец аккаунта](/access-control/user-types.mdx#account-owner) или пользователи с ролью [`iam.admin`](/access-control/role-reference.mdx#iam-admin).

### 2. Запустить Grafana \{#start-grafana}

:::info

Это инструкция для локального запуска Grafana.
Если у вас есть готовая инсталляция Grafana, запустите ее, используя инструкцию [Start the Grafana server](https://grafana.com/docs/grafana/latest/setup-grafana/start-restart-grafana/) официальной документации Grafana.

:::

1. Откройте CLI.

2. Запустите Grafana в Docker.

```bash
docker run -d -p 3000:3000 --name=grafana grafana/grafana
```

3. Откройте в браузере страницу `http://localhost:3000`.

4. Для подключения к Grafana введите данные по умолчанию — логин (`admin`) и пароль (`admin`).

### 3. Настроить источник данных \{#configure-data-source}

1. [Запустите Grafana](#start-grafana).

2. Перейдите в раздел **Data Sources**.

3. Нажмите **Add data source**.

4. Выберите [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/).

5. В поле **Name** укажите название для источника данных.

6. В блоке **Connection** в поле **Prometheus server URL** эндпоинт сервиса Метрики:

   ```bash
   <base_url>/projects/<project_id>/namespaces/<namespace>
   ```

   Укажите:

   * `<base_url>` — URL для обращения к API сервиса Метрики.
     Если вы настраиваете агент для сбора метрик [выделенного сервера](/dedicated/), используйте URL пула облачных серверов, который соответствует пулу, где расположен ваш выделенный сервер.
     Список URL можно посмотреть в подразделе [Метрики](/api/urls/#metrics) инструкции [Список URL](/api/urls/);
   * `<project_id>` — ID проекта. Можно скопировать в [панели управления](https://my.selectel.ru/vpc/): в верхнем меню нажмите **Продукты** и выберите **Облачные серверы** → откройте меню проектов → в строке нужного проекта нажмите <CopyIcon />;
   * `<namespace>` — имя выбранного пространства имен, например `compute`.
     Можно посмотреть в инструкции [Справочник метрик](/metrics/metrics-references.mdx).

7. В поле **Authentication method** выберите **Basic authentication**.

8. В поле **User** введите ID пользователя, которого вы [добавили на этапе 1](#add-service-user);

9. В поле **Password** введите пароль пользователя, которого вы [добавили на этапе 1](#add-service-user).

10. Нажмите **Save & test** и дождитесь выполнения тестового запроса.

### 4. Создать дашборд \{#create-dashboard}

1. [Запустите Grafana](#start-grafana).

2. Перейдите в раздел **Dashboards**.

3. Нажмите **Create dashboard**.

4. Нажмите **Add visualization**.

5. Выберите источник данных Prometheus, который вы [настроили на этапе 3](#configure-data-source).

6. На вкладке **Queries** в поле **Metrics** введите имя метрики.
   Подробнее о доступных метриках в инструкции [Справочник метрик](/metrics/metrics-references.mdx).

7. Опционально: чтобы добавить несколько метрик, нажмите **Add query** и повторите шаг 5.

8. Чтобы отобразить значения метрик на дашборде, нажмите **Run queries**.

9. Нажмите **Save dashboard**.

<Formbricks />