|
1 | | -# Agent Check: BlueCat Edge |
2 | | - |
3 | 1 | ## Overview |
4 | 2 |
|
5 | | -This check monitors [BlueCat Edge][1]. |
| 3 | +[BlueCat Edge][1] is an intelligent DNS resolver and caching layer that leverages existing DNS infrastructure to provide unprecedented visibility and control over DNS traffic. |
6 | 4 |
|
7 | | -## Setup |
| 5 | +This integration ingests the DNS query logs. |
| 6 | + |
| 7 | +- **DNS Query Logs**: Logs that capture DNS request and response activity, including queried domains and source clients. |
8 | 8 |
|
9 | | -### Installation |
| 9 | +Integrate BlueCat Edge with Datadog to analyze DNS query logs using pre-built dashboards. Datadog parses and enriches these logs using built-in log pipelines, supporting search and analysis. You can also use this data with Cloud SIEM detection rules for security monitoring. |
10 | 10 |
|
11 | | -The BlueCat Edge check is included in the [Datadog Agent][2] package. |
12 | | -No additional installation is needed on your server. |
| 11 | +## Setup |
13 | 12 |
|
14 | | -### Configuration |
| 13 | +### Generate API credentials in BlueCat Edge |
15 | 14 |
|
16 | | -!!! Add list of steps to set up this integration !!! |
| 15 | +1. Log in to **BlueCat Edge** using a user with the **Analyst** role or higher. |
| 16 | +2. Click the **Account > Profile** tab. |
| 17 | +3. In the **Access key sets** section, click **New**. The **Client ID** and **Secret key** are displayed. |
| 18 | +4. Identify your **BlueCat Edge Domain URL** using the URL of your BlueCat Edge cloud instance. |
| 19 | + - For example, if your BlueCat Edge cloud instance URL is **https://myBlueCat.edge.bluec.at/**, the BlueCat Edge Domain URL is **myBlueCat.edge.bluec.at**. |
17 | 20 |
|
18 | | -### Validation |
| 21 | +### Connect your BlueCat Edge account to Datadog |
19 | 22 |
|
20 | | -!!! Add steps to validate integration is functioning as expected !!! |
| 23 | +1. Add your `BlueCat Edge Domain`, `Client ID`, and `Secret key`. |
| 24 | + | Parameter | Description | |
| 25 | + | ---------- | ---------------------------------------------- | |
| 26 | + | BlueCat Edge Domain | The BlueCat Edge domain of the instance. | |
| 27 | + | Client ID | The Client ID for BlueCat Edge. | |
| 28 | + | Secret key | The secret key for BlueCat Edge. | |
| 29 | + | Collect NOERROR DNS Query Logs | Controls the collection of NOERROR DNS query logs. Enabled by default. | |
| 30 | +2. Click **Save**. |
21 | 31 |
|
22 | 32 | ## Data Collected |
23 | 33 |
|
| 34 | +### Logs |
| 35 | + |
| 36 | +The BlueCat Edge integration collects DNS query logs and forwards them to Datadog. |
| 37 | + |
24 | 38 | ### Metrics |
25 | 39 |
|
26 | | -BlueCat Edge does not include any metrics. |
| 40 | +The BlueCat Edge integration does not include any metrics. |
27 | 41 |
|
28 | 42 | ### Events |
29 | 43 |
|
30 | | -BlueCat Edge does not include any events. |
| 44 | +The BlueCat Edge integration does not include any events. |
31 | 45 |
|
32 | 46 | ## Troubleshooting |
33 | 47 |
|
34 | | -Need help? Contact [Datadog support][3]. |
| 48 | +Need help? Contact [Datadog support][2]. |
35 | 49 |
|
36 | | -[1]: **LINK_TO_INTEGRATION_SITE** |
37 | | -[2]: https://app.datadoghq.com/account/settings/agent/latest |
38 | | -[3]: https://docs.datadoghq.com/help/ |
| 50 | +[1]: https://bluecatnetworks.com/products/edge/ |
| 51 | +[2]: https://docs.datadoghq.com/help/ |
0 commit comments