enable-ssi

Configure Unified Service Tags on Linux hosts and verify Single Step Instrumentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linux hosts running the Datadog Agent with SSI often require unified service tagging to ensure traces are correctly labeled with service, environment, and version. This skill automates the configuration and verification process for SSI on Linux, enabling consistent tagging across services without code changes.

Core Features & Use Cases

  • Configure Unified Service Tags (DD_SERVICE, DD_ENV, DD_VERSION) on a running Linux service to ensure proper trace attribution.
  • Verify that SSI injection is armed and active by checking launcher presence and /proc/<pid>/maps contents, and that the service appears with the correct environment in its process environment.
  • Validate success in production or staging environments by re-checking service health and instrumentation after deployment.

Quick Start

Follow the steps to configure UST on a Linux host and verify SSI injection for a running service.

Frequently Asked Questions about enable-ssi

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

FAQPage Schema
How do I configure Unified Service Tags on a Linux service for Datadog Single Step Instrumentation?

To configure Unified Service Tags on a Linux service, apply DD_SERVICE, DD_ENV, and DD_VERSION variables to the target systemd service. This ensures environment and version data propagate to traces automatically without requiring code changes.

How does Single Step Instrumentation verify that a running Linux service is correctly tagged?

Single Step Instrumentation verifies tagging by checking the launcher presence and inspecting /proc/<pid>/maps contents. It confirms the service appears with the correct environment in its process environment to validate trace attribution.

Do I need SSH access to verify SSI injection on a remote Linux host?

Yes, SSH access is required to verify SSI injection on a remote Linux host. You must provide SSH_KEY, SSH_USER, and SSH_HOST variables to connect and check the systemd service environment and instrumentation status.

What variables are required to tag services and verify SSI on Linux hosts?

Tagging services and verifying SSI requires SERVICE_NAME, ENV, VERSION, SYSTEMD_SERVICE_NAME, SSH_KEY, SSH_USER, and SSH_HOST variables. Knowledge of the target systemd service is also necessary to ensure proper configuration.

What's the best way to automate Datadog trace tagging for a systemd service without code changes?

Automating Datadog trace tagging without code changes is done by applying Unified Service Tags via Single Step Instrumentation. This configures the target Linux service directly to inject service, environment, and version metadata into traces.

Why does my Datadog Agent SSI show missing environment or version data on Linux traces?

Missing environment or version data on Linux traces occurs when Unified Service Tags are not applied to the systemd service. Configuring DD_ENV and DD_VERSION variables through SSI ensures this data propagates correctly to trace attribution.