> For the complete documentation index, see [llms.txt](https://help.radiantsecurity.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.radiantsecurity.ai/log-management/grafana-plug-in/install-the-grafana-opensearch-plug-in-to-query-radiant-alerts.md).

# Install the Grafana OpenSearch Plug-In to Query Radiant Alerts

In this guide, you will use the OpenSearch plug-in from Grafana's plug-in library to analyze and visualize alerts generated by Radiant Security. You will create the connector in Radiant Security, then install and configure the plug-in in Grafana.

{% hint style="info" %}
**Note:** Before following this guide, ensure you have completed the steps in the [Install the Grafana Plug-In for Events](/log-management/grafana-plug-in/install-the-grafana-plug-in-to-query-events-in-the-radiant-log-manager.md) guide.
{% endhint %}

### **Requirements**

* [ ] A Grafana instance installed in your local or virtual environment.

### Configure the data connector in Radiant Security

1. Log in to [Radiant Security](https://app.radiantsecurity.ai/).
2. From the navigation menu, click **Settings** > **Data Connectors** and click **+ Add Connector**.
3. Search for and select the **Radiant Security Grafana Plug-In** option from the list and then click **Data** **Feeds**.
4. Under **Select your data feeds**, select **Grafana Security Ops - Radiant Alerts** and click **Credentials**.
5. Under **Credential** **Name**, give the credential an identifiable name (e.g. `Radiant-Security-Alerts`).
6. Under **Required** **Credentials**, in the **Connector** **tag** field enter a value. This value will act as the salt to randomize the unique **Token** you’ll download in the next step.
7. Click **Add Connector**.
8. Copy and save the connector **Token** value using the clipboard option or download the **Token** file. You will need this token to complete the configuration.
9. Click **Done** to save your changes.

### Install the OpenSearch plug-in in Grafana

1. In your Grafana instance, navigate to **Administration > Plugins and data > Plugins**.
2. Search for **OpenSearch**.
3. Select the **OpenSearch** plug-in and click **Install**.

### Create and configure a data source

{% hint style="warning" %}
**Important note:** All fields below are case sensitive.
{% endhint %}

After installing the OpenSearch plug-in, connect Grafana to Radiant Security by creating a new data source with your API token and endpoint URL.

1. Click **Add new data source** and configure the following fields:
2. For **Name**, enter a name for the plug-in (e.g. `RS-Alert-Source)`.
3. For **URL**, set the appropriate endpoint for your region: 
   * US region: `https://plugin.radiantsecurity.ai/grafana-plugins-proxy/es` 
   * EU region: `https://plugin.eu1.radiantsecurity.ai/grafana-plugins-proxy/es` .
4. Under the **Custom HTTP Headers** section, click **Add header** and fill out the details**:**
   * **Header**: `Authorization`
   * **Value**: `Bearer<ADD-SPACE><YOUR-RADIANT-TOKEN>`
5. In the **OpenSearch Details** section:
   * For **Index name**, enter: `radiant_alerts`
   * For **Time field name**, enter: `createdOn`
   * Click **Get Version and Save**. The value **OpenSearch (compatibility mode)** should populate automatically.

{% hint style="info" %}
**Note:** If you see the error *"Failed to connect to server"*, check that all values above have been entered correctly.
{% endhint %}

6. Click **Save & test**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.radiantsecurity.ai/log-management/grafana-plug-in/install-the-grafana-opensearch-plug-in-to-query-radiant-alerts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.