Skip to main content

Datadog proof types and queries

Note

Hyperproof connects to many third-party systems that frequently change, including the system interface. Contact your System Administrator or the third-party provider for assistance in meeting the requirements to integrate with Hyperproof and collect the proof you need.

When you create a Hypersync between Hyperproof and Datadog, you can automatically collect the following proof types:

Additional documentation

Note

You only need to connect Hyperproof to the app once, and then you can create as many Hypersyncs as you need. Additionally, you can create multiple Hypersyncs for a single control or label.

Connection configuration

To connect to Datadog and collect proof, your Datadog configuration must meet the following requirements.

Step One: Create a new Hypersync role

  1. Sign in to your Datadog account.

  2. From the Organization settings, navigate to Access > Roles.

  3. Highlight Datadog Read Only Role, then click the Clone icon.

  4. Add a name for the new role, i.e. Hyperproof/Hypersync Role.

  5. Configure the minimum required permissions for the Hypersync to work:

    • User App Keys

      Note

      This permission is NOT automatically included in the cloned Datadog Read Only Role, and needs to be manually added. This is required so the Hypersync can query metadata from the App Key belonging to the service account.

    • Client Token Read

    • Dashboards Read

    • Notebooks Read

    • Monitors Read

    • APM Read

    • RUM Apps Read

    • Incidents Read

    • SLOs Read

    • CI Visibility Read

  6. Click Save.

Step Two: Create a service account

  1. From the left menu, navigate to Identity & Accounts > Service Accounts.

  2. Click New Service Account.

  3. Enter a name, i.e. Hyperproof/Hypersync Account, and a company email.

  4. From the Assign Roles drop-down menu, select Hyperproof/Hypersync Role.

  5. Click Create Service Account.

Step Three: Create the App Key

  1. Select your newly created service account.

  2. In the right pane, click New Key.

  3. Enter a name, i.e. Hyperproof/Hypersync App Key.

  4. Click Create Key. The App Key has the permissions of the user who created it.

  5. Copy your newly created Application Key using the Copy button.

    Note

    Do not skip this step!

  6. Store your key securely, and then click Finish.

    Note

    Ensure that your Application Key is Not Scoped. Application Key permissions are inherited directly from the originating service account.

Step Four: Create the API Key

A Datadog administrator can create new API Keys.

  1. From the left menu, navigate to Access > API Keys.

  2. Click New Key.

  3. Enter a name, i.e. Hyperproof/Hypersync API Key.

  4. Click Create Key.

  5. Copy your newly created API Key using the Copy button.

    Note

    Do not skip this step!

  6. Store your key securely, and then click Finish.