DataDog Integration

Note: Application Performance Monitoring (APM) integrations are only available to Enterprise tier Vendia users. See full details on the Pricing page.

DataDog monitoring supports two modes: metric-only and logs-and-metrics. Either mode can be enabled or disabled from each node’s GraphQL API separately. DataDog cannot be set up on unis.vendia.net Uni nodes. See the RBAC documentation for more information about using a custom namespace to enable DataDog integrations.

The update_Settings mutation on each Uni Node keeps the settings for only that node, so to get metrics/logs from all nodes in a uni, these steps must be performed separately for each node. The example below is the mutation you will need to enable both the DataDog monitoring and log collection.

mutation addMyLogs {
  updateVendia_Settings(
    input: {
      aws: {
        dataDogMonitoring: {
          ddExternalId: "b5a..."
          ddApiKey: "6ea..."
          ddSendLogs: true
        }
      }
    }
    syncMode: ASYNC
  ) {
    transaction {
      _id
    }
  }
}

Metrics Only

To set up metrics, first go to the GraphQL Explorer page for your Uni and get the AWS Account ID for your node:

query getNodeAccountInfo {
  getVendia_UniInfo {
    localNodeName
    name
    nodes {
      name
      vendiaAccount {
        accountId
        csp
      }
    }
  }
}

The nodes.vendiaAccount.accountId that matches the localNodeName property will be the AWS account for the node. Save this AWS Account ID and the role name DatadogAWSIntegrationRole.

Go to the AWS integration setup page when logged into your DataDog organization. Click “Add Account” and copy the AWS Account ID and AWS Role name. DataDog will generate a secret AWS External ID that is used to gather metrics and other data from the AWS Account your Uni Node is running in.

Copy the External ID into this mutation:

mutation addMetrics {
  updateVendia_Settings(
    input: { aws: { dataDogMonitoring: { ddExternalId: "b5a..." } } }
    syncMode: ASYNC
  ) {
    transaction {
      _id
    }
  }
}

Submit the mutation and wait up to 15 minutes for the role to be created and for DataDog to attempt to use the role to gather test metrics. Click “Update Configuration” and you can expect metrics to begin to appear in DataDog’s Metric Explorer.

Logs And Metrics

To add log collection to the DataDog integration go to the DataDog logs tab/section and add a log source, or if it is your first log source use the log onboarding page to generate a DataDog API Key to allow DataDog to identify the logs forwarded from your Uni Node.

mutation addLogsAndMetrics {
  updateVendia_Settings(
    input: {
      aws: {
        dataDogMonitoring: {
          ddExternalId: "b5a...."
          ddApiKey: "6ea..."
          ddSendLogs: true
        }
      }
    }
    syncMode: ASYNC
  ) {
    transaction {
      _id
    }
  }
}

Paste the DataDog API Key and the original DataDog External ID into the mutation above to turn on log shipping. Logs can be expected to show up within approximately 10 minutes in the DataDog Live Tail view.