Datadog provides infrastructure monitoring, application performance monitoring, and log management in a single-pane-of-glass view so teams can scale rapidly and maintain operational excellence.

Installing the Datadog package via Google Cloud Launcher deploys the Datadog Agent on every node in your Kubernetes cluster, and configures it with a secure, RBAC-based authentication and authorization model.

Get up and running with a few clicks! Install the Datadog Agent daemonset to a Google Kubernetes Engine cluster using Google Cloud Marketplace.

Prior to that:

• Create a Datadog account
• Get your Datadog API key

Then follow the on-screen instructions.

Follow these instructions to install the Datadog Agent from the command line.

Your development environment should contain the following tools:

• gcloud
• kubectl
• git

• Create a Datadog account
• Get your Datadog API key

Create a new cluster from the command line:

export CLUSTER=datadog-cluster
export ZONE=us-west1-a

gcloud container clusters create "$CLUSTER" --zone "$ZONE"

Configure kubectl to connect to the new cluster:

gcloud container clusters get-credentials "$CLUSTER" --zone "$ZONE"

Clone this repository.

git clone [email protected]:DataDog/datadog-agent.git

An Application resource is a collection of individual Kubernetes components, such as Services, Deployments, and so on, that you can manage as a group.

To set up your cluster to understand Application resources, navigate to the google-marketplace folder in the repository, and run the following command:

make crd/install

You need to run this command once.

The Application resource is defined by the Kubernetes SIG-apps community. The source code can be found on github.com/kubernetes-sigs/application.

Navigate to the google-marketplace folder:

cd datadog-agent/google-marketplace

Choose an instance name and namespace for the app. In most cases, you can use the default namespace.

export namespace=default
export name=datadog-agent

Configure the container image:

export datadogAgentImage=datadog/agent:latest

The image above is referenced by tag. We recommend that you pin each image to an immutable content digest. This ensures that the installed application always uses the same images, until you are ready to upgrade.

Fill in your Datadog API key:

export apiKeyEncoded=$(echo YOUR_DATADOG_API_KEY | base64)

The Datadog Agent needs a service account in the target namespace with cluster wide permissions to inspect Kubernetes resources.

Create a ClusterRole in your target Kubernetes cluster, a ServiceAccount in the namespace specified earlier, and a ClusterRoleBinding to tie them together:

export serviceAccount=datadog-agent-sa
make rbac/install  # from the datadog-agent/google-marketplace folder

Install the Datadog Agent with the following command:

make app/install

This expands the templates located in the datadog-agent/google-marketplace/manifest folder with the parameters given previously, and apply them, creating a Secret for the API key, and a DaemonSet tied to the service account previously created.

Once the application is installed, your Kubernetes nodes show up in your Datadog Infrastructure Map and metrics start flowing to your Datadog account!

To further configure your agents, and setup your account, refer to the Datadog documentation.

The agent is stateless, and all your data is backed up in your Datadog account.

The agent is deployed as a DaemonSet, it will automatically scale with your cluster.

Remove the agent resources following the on-screen instructions.

Or if you followed the command line instructions, by running the following commands from the datadog-agent/google-marketplace folder:

make app/uninstall
make rbac/uninstall
export serviceAccount=datadog-agent-sa
make rbac/install  # from the datadog-agent/google-marketplace folder