+ "original": "# Integration with Grafana\n\n> NOTE: The integration with Grafana requires [Manticore Buddy](../Installation/Manticore_Buddy.md). If it doesn't work, make sure Buddy is installed.\n\n[Grafana](https://grafana.com/) is an open-source data visualization and monitoring platform that allows you to create interactive dashboards and charts. Manticore Search integrates seamlessly with Grafana using the default MySQL connector, enabling you to visualize search data, monitor performance metrics, and analyze trends in real-time.\n\nCurrently, Grafana versions 10.0-12.2 are tested and supported.\n\n## Prerequisites\n\nBefore integrating Manticore Search with Grafana, ensure that:\n\n1. Manticore Search (version 6.2.0 or later) is properly installed and configured on your server. Refer to the [official Manticore Search installation guide](../Installation/Installation.md) for assistance.\n\n2. Grafana is set up on your system. Follow the [official Grafana installation guide](https://grafana.com/docs/grafana/latest/setup-grafana/installation/) for installation instructions.\n\n## Connecting Manticore Search to Grafana\n\nTo connect Manticore Search to Grafana:\n\n1. Log in to your Grafana dashboard and click on \"Configuration\" (the gear icon) in the left sidebar.\n\n2. Select \"Data Sources\" and click on \"Add data source.\"\n\n3. Choose \"MySQL\" from the list of available data sources.\n\n4. In the settings page, provide the following details:\n\n - **Name**: A name for the data source (e.g., \"Manticore Search\")\n\n - **Host**: The hostname or IP address of your Manticore Search server (with MySQL port, default: `localhost:9306`)\n\n - **Database**: Leave empty or specify your database name\n\n - **User**: The username with access to Manticore Search (default: `root`)\n\n - **Password**: The password for the specified user (default: empty)\n\n5. Click on \"Save & Test\" to verify the connection.\n\n## Creating Visualizations and Dashboards\n\nAfter connecting Manticore Search to Grafana, you can create dashboards and visualizations:\n\n1. In the Grafana dashboard, click on the \"+\" icon in the left sidebar and select \"New dashboard.\"\n\n2. Click on the \"Add visualization\" button to start configuring your chart.\n\n3. Choose the Manticore Search data source that you connected via the MySQL connector.\n\n4. Select the type of chart you want to create (e.g., Time Series, Bar chart, Candlestick, Pie chart).\n\n5. Use Grafana's query builder or write an SQL query to fetch data from your Manticore Search tables.\n\n6. Customize the chart's appearance, labels, and other settings as needed.\n\n7. Click \"Apply\" to save your visualization to the dashboard.\n\n## Example Use Case\n\nHere's a simple example using time-series data. First, create a table and load sample data:\n\nCODE_BLOCK_0\n\nLoad the data:\n\nCODE_BLOCK_1\n\nIn Grafana, you can create:\n\n- **Time Series chart**: Visualize price changes over time\n\n- **Candlestick chart**: Display open, high, low, close values for financial data\n\n- **Aggregation charts**: Use COUNT, AVG, MAX, MIN functions\n\nExample queries:\n\nCODE_BLOCK_2\n\n## Supported Features\n\nWhen working with Manticore Search through Grafana, you can:\n\n- Execute SQL queries against Manticore Search tables\n\n- Use aggregation functions: COUNT, AVG, MAX, MIN\n\n- Apply GROUP BY and ORDER BY operations\n\n- Filter data with WHERE clauses\n\n- Access table metadata via `information_schema.tables`\n\n- Create various visualization types supported by Grafana\n\n## Limitations\n\n- Some advanced MySQL features may not be available when working with Manticore Search through Grafana.\n\n- Only features supported by Manticore Search are available. Refer to the [SQL reference](../Searching/Full_text_matching/Basic_usage.md) for details.\n\n## References\n\nFor more information and detailed tutorials:\n\n- [Grafana integration blog post](https://manticoresearch.com/blog/manticoresearch-grafana-integration/)\n\n- [Official Grafana documentation](https://grafana.com/docs/)",
0 commit comments