Nouvelles annonces sur les technologies sans serveur et réseau ainsi que sur le RUM (Real-User Monitoring) dévoilées à la conférence Dash ! Nouvelles annonces dévoilées à la conférence Dash !

Getting Started with the Agent

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Overview

The Agent is lightweight software installed on your hosts. It reports metrics and events from your host to Datadog via integrations, DogStatsD, or the API. With additional setup, the Agent can report live processes, logs, and traces.

Setup

If you haven’t already, create a Datadog account.

Installation

The Agent can be installed on many different platforms either directly on the host or as a containerized version. Most systems have a one-line install option.

Choose your platform to see installation instructions:

Configuration

The Agent’s main configuration file is datadog.yaml. The only required parameter is your Datadog API key which is used to associate your Agent’s data with your organization. See the sample config_template.yaml for all available configuration options.

For the container Agent, datadog.yaml configuration options are passed in with environment variables. For example, the Datadog API key environment variable is DD_API_KEY.

The Agent’s main configuration file is datadog.yaml. The required parameters are your Datadog API key which is used to associate your Agent’s data with your organization and the Datadog Site (datadoghq.eu). See the sample config_template.yaml for all available configuration options.

For the container Agent, datadog.yaml configuration options are passed in with environment variables, for example:

  • DD_API_KEY for the Datadog API key
  • DD_SITE for the Datadog site

Validation

Run the Agent’s status command to verify installation.

Commands

Refer to the Agent Commands page to Start, Stop or Restart your Agent.

Data Collected

Metrics

Depending on your platform, the Agent has several core checks enabled by default that collect metrics.

CheckMetricsPlatforms
CPUSystemAll
DiskDiskAll
DockerDockerDocker
File HandleSystemAll except Mac
IOSystemAll
LoadSystemAll except Windows
MemorySystemAll
NetworkNetworkAll
NTPNTPAll
UptimeSystemAll
WinprocSystemWindows

To collect metrics from other technologies, see the Integrations page.

Events

The Agent sends events to Datadog when an Agent is started or restarted.

Service Checks

datadog.agent.up:
Returns CRITICAL if the Agent is unable to connect to Datadog, otherwise returns OK.

datadog.agent.check_status:
Returns CRITICAL if an Agent check is unable to send metrics to Datadog, otherwise returns OK.

Troubleshooting

For help troubleshooting the Agent:

Further Reading

Next Steps