Install Grafana Agent in static mode on Linux
You can install Grafana Agent in static mode on Linux.
Install on Debian or Ubuntu
To install Grafana Agent in static mode on Debian or Ubuntu, run the following commands in a terminal window.
Import the GPG key and add the Grafana package repository:
shellsudo mkdir -p /etc/apt/keyrings/ wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
Update the repositories:
shellsudo apt-get update
Install Grafana Agent:
shellsudo apt-get install grafana-agent
Uninstall on Debian or Ubuntu
To uninstall Grafana Agent on Debian or Ubuntu, run the following commands in a terminal window.
Stop the systemd service for Grafana Agent:
shellsudo systemctl stop grafana-agent
Uninstall Grafana Agent:
shellsudo apt-get remove grafana-agent
Optional: Remove the Grafana repository:
shellsudo rm -i /etc/apt/sources.list.d/grafana.list
Install on RHEL or Fedora
To install Grafana Agent in static mode on RHEL or Fedora, run the following commands in a terminal window.
Import the GPG key:
shellwget -q -O gpg.key https://rpm.grafana.com/gpg.key sudo rpm --import gpg.key
Create
/etc/yum.repos.d/grafana.repo
with the following content:shell[grafana] name=grafana baseurl=https://rpm.grafana.com repo_gpgcheck=1 enabled=1 gpgcheck=1 gpgkey=https://rpm.grafana.com/gpg.key sslverify=1 sslcacert=/etc/pki/tls/certs/ca-bundle.crt
Optional: Verify the Grafana repository configuration:
shellcat /etc/yum.repos.d/grafana.repo
Install Grafana Agent:
shellsudo dnf install grafana-agent
Uninstall on RHEL or Fedora
To uninstall Grafana Agent on RHEL or Fedora, run the following commands in a terminal window:
Stop the systemd service for Grafana Agent:
shellsudo systemctl stop grafana-agent
Uninstall Grafana Agent:
shellsudo dnf remove grafana-agent
Optional: Remove the Grafana repository:
shellsudo rm -i /etc/yum.repos.d/rpm.grafana.repo
Install on SUSE or openSUSE
To install Grafana Agent in static mode on SUSE or openSUSE, run the following commands in a terminal window.
Import the GPG key and add the Grafana package repository:
shellwget -q -O gpg.key https://apt.grafana.com/gpg.key sudo rpm --import gpg.key sudo zypper addrepo https://rpm.grafana.com grafana
Update the repositories:
shellsudo zypper update
Install Grafana Agent:
shellsudo zypper install grafana-agent
Uninstall on SUSE or openSUSE
To uninstall Grafana Agent on SUSE or openSUSE, run the following commands in a terminal:
Stop the systemd service for Grafana Agent:
shellsudo systemctl stop grafana-agent
Uninstall Grafana Agent:
shellsudo zypper remove grafana-agent
Optional: Remove the Grafana repository:
shellsudo zypper removerepo grafana
Operation guide
The Grafana Agent is configured as a systemd service.
Start the Agent
To run Grafana Agent, run the following in a terminal:
sudo systemctl start grafana-agent
To check the status of Grafana Agent, run the following command in a terminal:
sudo systemctl status grafana-agent
Run Grafana Agent on startup
To automatically run Grafana Agent when the system starts, run the following command in a terminal:
sudo systemctl enable grafana-agent.service
Configuring Grafana Agent
To configure Grafana Agent when installed on Linux, perform the following steps:
Edit the default configuration file at
/etc/grafana-agent.yaml
.Run the following command in a terminal to reload the configuration file:
shellsudo systemctl reload grafana-agent
View Grafana Agent logs
Logs of Grafana Agent can be found by running the following command in a terminal:
sudo journalctl -u grafana-agent
Next steps
Was this page helpful?
Related resources from Grafana Labs
![Getting started with the Grafana LGTM Stack](/static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=200 200w, /static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=400 400w)
![Intro to Kubernetes monitoring in Grafana Cloud](/media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=200 200w, /media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=400 400w)
![Building advanced Grafana dashboards](/media/webinar/AMER_buildadv_notxt.png?w=200 200w, /media/webinar/AMER_buildadv_notxt.png?w=400 400w)