dd-audit-key-compromise

Analyze Datadog audit logs for compromised API key usage history.

150|23|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/datadog-labs/agent-skills --skill dd-audit-key-compromise
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dd-audit-key-compromise
Source: https://github.com/datadog-labs/agent-skills/tree/main/dd-audit/key-compromise
Command: npx skills add https://github.com/datadog-labs/agent-skills --skill dd-audit-key-compromise

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pup, jq, audit-logs, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables in-depth investigation of compromised Datadog API keys, uncovering their activity history and identifying affected resources.

Core Features & Use Cases

  • Timeline Reconstruction: Reconstruct the sequence of actions taken with the compromised key.
  • Geo/IP Analysis: Analyze where the key was used from, providing a geolocation breakdown.
  • Endpoint and Action Breakdown: Breakdown the endpoints called and the actions performed with the compromised key.
  • Destructive Action Check: Detects if the key performed any destructive actions such as deleting resources.
  • Anomaly Flags: Identifies unusual activities or patterns indicative of key compromise.
  • Quick Start: Use this Skill to investigate the usage and impact of a potentially compromised key.

Quick Start

Investigate API key compromise using 'KEY_ID'. Generate the timeline of actions for this key with 'pup audit-logs search'.

Frequently Asked Questions about dd-audit-key-compromise

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate a compromised Datadog API key using audit logs?

To investigate a compromised Datadog API key, analyze audit logs using 'pup audit-logs search' with the KEY_ID. This reconstructs the timeline of actions, performs geolocation analysis, and identifies affected resources.

What does API key compromise analysis reveal about destructive actions?

API key compromise analysis detects destructive actions performed with the compromised key, such as deleting resources. It flags these anomalies alongside endpoint breakdowns and usage patterns to assess the full impact of the misuse.

Do I need jq and pup to perform a Datadog API key security audit?

Yes, you need jq and pup to perform a Datadog API key security audit. These dependencies are required to retrieve and process audit log event data for uncovering usage history and affected resources.

Can I trace the geolocation and IP addresses of a compromised Datadog API key?

Yes, you can trace the geolocation and IP addresses of a compromised Datadog API key. The analysis provides a geolocation breakdown to identify where the key was used from during the post-compromise security audit.

What is the best way to reconstruct an activity timeline for a compromised Datadog API key?

The best way to reconstruct an activity timeline for a compromised Datadog API key is by querying audit logs. This uncovers the sequence of actions taken, breaking down the endpoints called and actions performed.

How does anomaly detection work during a Datadog API key compromise investigation?

Anomaly detection during an API key compromise investigation works by identifying unusual activities or patterns indicative of misuse. It flags these irregularities in the audit logs to highlight potential security incidents.