Menu

Caution

Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Install Grafana Agent Flow with Chef

You can use Chef to install and manage Grafana Agent Flow.

Before you begin

  • These steps assume you already have a working Chef setup.
  • You can add the following resources to any new or existing recipe.
  • These tasks install Grafana Agent Flow from the package repositories. The tasks target Linux systems from the following families:
    • Debian (including Ubuntu)
    • RedHat Enterprise Linux
    • Amazon Linux
    • Fedora

Steps

To add Grafana Agent Flow to a host:

  1. Add the following resources to your Chef recipe to add the Grafana package repositories to your system:

    ruby
    if platform_family?('debian', 'rhel', 'amazon', 'fedora')
      if platform_family?('debian')
        remote_file '/etc/apt/keyrings/grafana.gpg' do
          source 'https://apt.grafana.com/gpg.key'
          mode '0644'
          action :create
          end
    
        file '/etc/apt/sources.list.d/grafana.list' do
          content "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com/ stable main"
          mode '0644'
          notifies :update, 'apt_update[update apt cache]', :immediately
        end
    
        apt_update 'update apt cache' do
          action :nothing
        end
      elsif platform_family?('rhel', 'amazon', 'fedora')
        yum_repository 'grafana' do
          description 'grafana'
          baseurl 'https://rpm.grafana.com/oss/rpm'
          gpgcheck true
          gpgkey 'https://rpm.grafana.com/gpg.key'
          enabled true
          action :create
          notifies :run, 'execute[add-rhel-key]', :immediately
        end
    
        execute 'add-rhel-key' do
          command "rpm --import https://rpm.grafana.com/gpg.key"
          action :nothing
        end
      end
    else
        fail "The #{node['platform_family']} platform is not supported."
    end
  2. Add the following resources to install and enable the grafana-agent-flow service:

    ruby
    package 'grafana-agent-flow' do
      action :install
      flush_cache [ :before ] if platform_family?('amazon', 'rhel', 'fedora')
      notifies :restart, 'service[grafana-agent-flow]', :delayed
    end
    
    service 'grafana-agent-flow' do
      service_name 'grafana-agent-flow'
      action [:enable, :start]
    end

Configuration

The grafana-agent-flow package installs a default configuration file that doesn’t send telemetry anywhere.

The default configuration file location is /etc/grafana-agent-flow.river. You can replace this file with your own configuration or create a new configuration file for the service to use.

Next steps