This is documentation for the next version of Agent. For the latest stable release, go to the latest version.

Documentation Grafana Agent Flow mode Get started Install Chef

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 Copy

   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 Copy

   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

• Configure Grafana Agent Flow