Datadog
Visualize Datadog services and users, and monitor changes to Datadog users through queries and alerts.
- Installation
- Data Model
- Types
- Release Notes
Installation
Before setting up the integration within JupiterOne, you will need to create an API key and an Application key in Datadog.
-
To create your API key: navigate to your Datadog organization's API keys and select New Key.
-
To create an application key: navigate to your Datadog organization's application keys and select New Key.
By default, an application key has the permissions of the user who created it. If you scope the application key, it must include at minimum the following permissions for all steps to succeed:
user_access_read— read users and their roles and settings.hosts_read— list hosts and their attributes (granted by the Datadog Read Only Role).
noteFor more detail on API and application keys, see the Datadog API and Application Keys documentation. For how each permission maps to roles, see the Datadog RBAC permissions reference.
Configuration in JupiterOne
To install the Datadog integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Datadog. Click New Instance to begin configuring your integration.
Creating an instance requires the following:
-
The Account Name used to identify the Datadog account in JupiterOne. Ingested entities will have this value stored in
tag.AccountNamewhen theAccountNametoggle is enabled. -
Description to assist in identifying the integration instance, if desired.
-
Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as
DISABLEDand manually execute the integration. -
Your Datadog Api Key — the API key that was generated when selecting New Key in the Datadog API Keys section.
-
Your Datadog App Key — the application key that was generated when selecting New Key in the Datadog Application Keys section.
-
Your Datadog Email — the email of the Datadog account used for the integration.
-
Optionally, your Datadog Host — the host of your Datadog account. The default Datadog US host is
datadoghq.comand the EU host isdatadoghq.eu. -
Optionally, your Datadog Organization Public ID — the public ID of your Datadog organization. When provided, the integration retrieves additional organization information for the account.
Click Create once all values are provided to finalize the integration.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Entities
The following entities are created:
| Resources | Entity _type | Entity _class |
|---|---|---|
| Account | datadog_account | Account |
| Host | datadog_host | Host |
| Role | datadog_role | AccessRole |
| User | datadog_user | User |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
|---|---|---|
datadog_account | HAS | datadog_user |
datadog_account | HAS | datadog_role |
datadog_account | HAS | datadog_host |
datadog_user | ASSIGNED | datadog_role |
Datadog Account
datadog_account inherits from Account
Datadog Host
datadog_host inherits from Host
| Property | Type | Description | Specifications |
|---|---|---|---|
agentVersion | string | ||
aliases | array of strings | ||
apps | array of strings | ||
awsName | string | ||
hostCpuCores | number | ||
id * | string | ||
isMuted | boolean | ||
machine | string | ||
name | string | ||
platform | string | ||
processor | string | ||
pythonVersion | string | ||
reportedOn | number | ||
socketFqdn | string | ||
socketHostname | string | ||
sources | array of strings | ||
state | string |
Datadog Role
datadog_role inherits from AccessRole
| Property | Type | Description | Specifications |
|---|---|---|---|
createdAt | number | ||
modifiedAt | number | ||
userCount | number |
Datadog User
datadog_user inherits from User
| Property | Type | Description | Specifications |
|---|---|---|---|
disabled | boolean | ||
icon | string | ||
verified | boolean |
Release Notes
- 2022-11-17 — Added host entity ingestion to the Datadog integration, enabling visibility into monitored infrastructure hosts and their properties.
- 2021-11-17 — New Datadog integration: ingests account information, users, and roles, enabling identity and access visibility for Datadog organizations.