Automate Datadog Agent Install on Linux with SSI

Where this fits

You're responsible for a fleet of Linux VMs that need Datadog APM. You want automatic instrumentation without touching application code or rebuilding containers. Manually SSHing into each host, checking for existing agents, and running the correct install script is error-prone and time-consuming. The agent-install skill gives your AI agent a structured, battle-tested procedure to do this safely and consistently.

Why agents benefit

• Preflight checks: The skill instructs the agent to verify whether the Datadog Agent is already installed using datadog-agent status before taking any action, preventing duplicate installs.
• Credential handling: It includes a Phase 0 to load DD_API_KEY from an environment file, so the agent never hardcodes secrets or prompts for them mid-task.
• SSH orchestration: The skill provides a clear sequence of SSH commands, so the agent can execute installs across multiple hosts without guessing or improvising.
• SSI enablement: It ensures Single Step Instrumentation is turned on during installation, meaning APM traces start flowing automatically without code changes or restarts.
• Guardrails: The skill explicitly lists when not to invoke it (e.g., Kubernetes clusters), reducing the risk of the agent applying the wrong deployment method.

Practical scenarios

Onboarding a new VM fleet

You've just provisioned 20 Ubuntu instances for a microservices rollout. Instead of writing a bash loop, you ask your agent to "install Datadog Agent with SSI on all hosts listed in inventory.json." The agent checks each host, skips any that already have the agent, and reports a summary of successful installs.

Preparing a staging environment

Your staging environment mirrors production but lacks monitoring. You instruct the agent to "set up Datadog on all staging VMs." The skill's step-by-step flow ensures the agent uses the correct staging API key and enables SSI, so you can validate trace collection before promoting to production.

Recovering from a failed install

A previous manual install left some hosts half-configured. You ask the agent to "fix Datadog agent installation on the dev cluster." The skill's initial status check identifies which hosts are missing or broken, and the agent reinstalls only those, avoiding unnecessary disruption.

Add it to your agent workflow

Install the skill via:

npx skills add datadog-labs/agent-skills --skill agent-install

Then, in your agent prompt, you might say:

Use the agent-install skill to install the Datadog Agent with SSI on all Linux hosts in the file hosts.txt. Load credentials from the environment file.

The skill will guide the agent through credential loading, status checks, and the SSH install process, ensuring a reliable, repeatable outcome. For more details, see the skill page on OpenAgentSkill.

Compare before adopting

Before making agent-install a permanent part of your agent's toolkit, compare it against:

• Quality signals: Check the repository's activity, issue resolution, and star count (currently 165). A low-maintenance skill may become stale as Datadog's installation APIs evolve.
• Alternatives: You could write your own shell script or use Datadog's official Ansible role, but those lack the agent-friendly structure and guardrails this skill provides.
• Workflow fit: Ensure the skill matches your target environment—it's explicitly for Linux hosts via SSH, not Kubernetes. If you use K8s, look for dd-apm-k8s-agent-install instead.

Why it is worth tracking

This skill is part of the official datadog-labs/agent-skills repository, which signals active maintenance and community trust. With 165 stars and a clear scope, it's a reliable building block for any agent that manages Linux infrastructure. Revisit it periodically—especially after Datadog releases new Agent versions or changes SSI defaults—to ensure your automation stays current.