Skip to content

Latest commit

 

History

History

fluxcd

Agent Check: fluxcd

Overview

This check monitors Flux through the Datadog Agent. Flux is a set of continuous and progressive delivery solutions for Kubernetes that is open and extensible.

Setup

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the Autodiscovery Integration Templates for guidance on applying these instructions.

Installation

Starting from Agent release 7.51.0, the Fluxcd check is included in the Datadog Agent package. No additional installation is needed on your server.

For older versions of the Agent, use these steps to install the integration.

Configuration

This integration supports collecting metrics and logs from the following Flux services:

  • helm-controller
  • kustomize-controller
  • notification-controller
  • source-controller

You can pick and choose which services you monitor depending on your needs.

Metric collection

This is an example configuration with Kubernetes annotations on your Flux pods. See the sample configuration file for all available configuration options.

apiVersion: v1
kind: Pod
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/manager.checks: |-
      {
        "fluxcd": {
          "instances": [
            {
              "openmetrics_endpoint": "http://%%host%%:8080/metrics"
            }
          ]
        }
      }
    # (...)
spec:
  containers:
    - name: 'manager'
# (...)

Log collection

Available for Agent versions >6.0

Flux logs can be collected from the different Flux pods through Kubernetes. Collecting logs is disabled by default in the Datadog Agent. To enable it, see Kubernetes Log Collection.

See the Autodiscovery Integration Templates for guidance on applying the parameters below.

Parameter Value
<LOG_CONFIG> {"source": "fluxcd", "service": "<SERVICE_NAME>"}

Validation

Run the Agent's status subcommand and look for fluxcd under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The fluxcd integration does not include any events.

Service Checks

See service_checks.json for a list of service checks provided by this integration.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles: