# Grafana 集成

## 介绍

我们很兴奋地宣布，**Manticore Search** 从 [6.2.0](/install/) 开始可以无缝集成到 **Grafana**，这个流行的开源数据可视化和监控平台。通过利用默认的 MySQL 连接器，您现在可以以更动态和信息丰富的方式可视化 Manticore Search 数据。这种集成为搜索性能优化、趋势分析和实时洞察带来了新的可能性。

> **注意：** 最新版本的 Manticore Search 与 Grafana 10.0-13.0 版本兼容。

在接下来的部分中，我们将引导您完成将 **Manticore Search** 连接到 **Grafana** 的过程，并帮助您创建第一个图表。

## 分步教程

### 步骤 1：安装和配置 Manticore Search

在将 **Manticore Search** 连接到 **Grafana** 之前，请确保已在服务器上安装并配置了 **Manticore Search**。请按照 [官方 Manticore Search 文档](https://manual.manticoresearch.com/Installation/Installation) 中的安装和设置说明进行操作。

### 步骤 2：设置 Grafana

要设置 Grafana，请遵循官方的 [Grafana 安装指南](https://grafana.com/docs/grafana/latest/setup-grafana/installation/)。

### 步骤 3：准备 Manticore Search 数据以进行可视化

在下一步中，您需要准备并在 Manticore Search 中创建表，然后加载数据以帮助我们生成图表并使用 Grafana 进行可视化。使用 MySQL 客户端连接到 Manticore，并执行以下查询：

我们将使用以下结构：

```sql
CREATE TABLE btc_usd_trading (
id bigint,
time timestamp,
open float,
high float,
low float,
close float
);
```

现在，让我们添加一些数据来填充表格。只需打开终端并运行以下命令：

```bash
curl -sSL https://gist.githubusercontent.com/donhardman/df109ba6c5e690f73198b95f3768e73f/raw/0fab3aee69d7007fad012f4e97f38901a64831fb/btc_usd_trading.sql | mysql -h0 -P9306
```

### 步骤 4：将 Manticore Search 连接到 Grafana

![通过 MySQL 连接](./manticoresearch-grafana-integration/connect-via-mysql.png)

1. 登录到您的 **Grafana** 仪表板，然后在左侧边栏中点击“配置”（齿轮图标）。
2. 选择“数据源”并点击“添加数据源”。
3. 从可用数据源列表中选择“MySQL”。

![MySQL 连接设置](./manticoresearch-grafana-integration/mysql-connection-settings.png)

4. 在设置页面中，提供以下详细信息：
    - 名称：数据源的名称（例如，“Manticore Search”）。
    - 主机：您的 Manticore Search 服务器的主机名或 IP 地址。
    - 数据库：您的 Manticore Search 数据库名称。
    - 用户：具有访问指定 Manticore Search 数据库权限的用户名。
    - 密码：指定用户的密码。
5. 点击“保存并测试”以验证连接。

### 步骤 5：创建仪表板并添加图表

1. 在 Grafana 仪表板中，点击左侧边栏中的“+”图标，然后选择“新建仪表板”。
    ![新建仪表板](./manticoresearch-grafana-integration/new-dashboard.png)
2. 点击“添加可视化”按钮以开始配置您的图表。
    ![添加可视化](./manticoresearch-grafana-integration/add-visualization.png)
3. 选择通过 MySQL 连接器连接的 Manticore Search 数据源。
    ![选择数据源](./manticoresearch-grafana-integration/select-data-source.png)
4. 从可用的可视化选项列表中选择您要创建的图表类型（例如，条形图、折线图、饼图）。我们将选择“时间序列”。
    ![选择图表类型](./manticoresearch-grafana-integration/choose-type-of-chart.png)

### 步骤 6：配置图表

1. 使用 Grafana 的查询构建器或直接编写 SQL 查询，从您的 Manticore Search 数据库中获取要可视化的数据。
2. 根据需要自定义图表的外观、标签和其他设置。
3. 点击“应用”以保存您的图表。
    ![图表查询设置](./manticoresearch-grafana-integration/chart-query-settings.png)

### 步骤 7：检查图表结果

以下是使用提供的数据获得的结果示例。

![时间序列结果](./manticoresearch-grafana-integration/time-series-result.png)

更改图表样式很容易，例如在这个示例中，我们使用了比特币价格。只需选择蜡烛图并调整查询构建器以选择所有字段。这将为您提供在 **Grafana** 中数据的完全不同的视图。

![蜡烛图类型](./manticoresearch-grafana-integration/candlestick-chart-type.png)
![蜡烛图查询设置](./manticoresearch-grafana-integration/candlestick-query-settings.png)
![蜡烛图结果](./manticoresearch-grafana-integration/candlestick-result.png)

您还可以根据 **Manticore Search** 数据库中的数据使用 **Grafana** 中的不同类型的可视化。只需连接您的 Manticore Search，选择表格，然后使用默认的 MySQL 连接器创建具有所需参数的图表。

通过结合不同图表的数据，构建您自己的仪表板！

![仪表板示例](./manticoresearch-grafana-integration/grafana-dashboard-sample.webp)

## 结论

通过使用默认的 MySQL 连接器无缝集成 **Manticore Search** 和 **Grafana**，您现在可以释放搜索数据的全部潜力。在直观的 **Grafana** 界面中轻松可视化趋势、性能指标和实时洞察。今天就开始，将您的数据分析能力提升到新的高度。