# Appendix D - Datadog Integration
N2W Backup & Recovery Instance is now supporting the monitoring of backups, DR, copy to S3, alerts, and more by Datadog. Datadog is a monitoring service for cloud-scale applications, providing monitoring of servers, databases, tools, and services, through a SaaS-based data analytics platform. Datadog will allow CPM users to monitor and analyze the N2W Backup & Recovery Dashboard metrics.
## **D.1 Activating Datadog and Monitoring N2W**
Use the following procedure to activate Datadog. Ready-made dashboards for monitoring are included.
**To activate the service and to monitor your N2W instance:**
1. **Setup Datadog Account.**
Visit Datadog at and set up an account that fits your scale.
2. **Install Python Integration.**
a. Login to Datadog and go to **Integrations.**
b. Search for ‘Python’ and install it:
.png)
c. Search for 'N2WS' and install it. See step 6.
3\. **Enable Datadog support on N2W Instance.** \
a. Connect to your N2W Backup & Recovery Instance with SSH Client. \
b. Type `sudo su`. \
c. Add the following lines to `/cpmdata/conf/cpmserver.cfg`:
```
[external_monitoring]
enabled=True
```
{% hint style="info" %}
If `cpmserver.cfg` doesn't exist, create, and add the above lines.
{% endhint %}
d. Run `service apache2 restart`.
4\. **Install Datadog Agent on N2W Instance.** \
a. Login to Datadog and go to **Integrations** **> Install Agents > Linu**x:
.png)
b. In step 3 of the Install the Datadog Agent on Linux page, create the install command by selecting an **API Key**, and then selecting **Use API Key**.
.png)
c. Use the copy icon in the upper right corner of the code block to copy the entire agent install command.
d. Connect to your N2W Backup & Recovery Instance with SSH Client, type `sudo su` and run the agent **Install** command. \
e. Restart the Datadog Agent: `sudo service datadog-agent restart`
{% hint style="info" %}
Datadog updates N2W metrics hourly.
{% endhint %}
5\. **Setup Datadog Dashboard metrics.** \
a. Log in to Datadog and go to **Metrics** > **Explorer**. \
b. In the **Graph** list, select your metrics. All N2W metrics begin with **`cpm_`** followed by ``.
c. In the **Over** list, select data. You can either select a specific user or the entire N2W instance. All N2W user data begins with **`cpm:user:`** followed by ``.
6\. **Configure your Datadog dashboard by using the N2W template or creating your own dashboards, and choose the data to monitor.** \
a. To use the N2WS template, in Datadog Integrations at , search for the '**N2WS**' tile and install it. You will get a variety of dashboards for your account. Dashboards are named 'N2WBackup\&Recovery-\'. When dashboards are added for a new N2W version, the dashboards will contain the version number, such as '3-2-0' and '4-0-0'. Version numbers indicate which dashboards are valid for versions going forward.\
b. To create a Datadog dashboard: \
i. Go to **Dashboards** and select **New Dashboard**.
ii. Add a graph type by dragging and dropping its template to the dashboard:
iii. Edit the graph for the data to be monitored:
iv. Save the graph settings.
7\. **View N2W Alerts on Datadog Events.** \
a. Log in to Datadog and go to **Events**. \
b. View your instance alerts:
## D.2 Monitoring N2W with Web Proxy
If you have restricted outbound traffic, you can proxy all Datadog Agent traffic through different hosts.
1. Connect to your N2W Backup & Recovery Instance with SSH Client.
```
cd /etc/datadog-agent
```
2\. Enable **proxy:** section on `datadog.yaml`. \
3\. Add your proxy IP, port, username, and password:
```
https: "http://your-proxy-IP:your-proxy-port"
http: "http://your-proxy-IP:your-proxy-port"
```
4\. Validate **datadog.yaml** on .
Example:
```
proxy:
http://54.159.14.45:3128
http://54.159.145.45:3128
```
For additional proxy configuration options, see
---
# Agent Instructions: 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:
```
GET https://docs.n2ws.com/user-guide/appendix-d-datadog-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
.png)