Longview - Get Started
View real-time system metrics and resource utilization to gain insight into your Linux-based cloud workloads.
To start using Longview to capture metrics from a Linux server, you need to create a new Longview Client instance and install the Longview Agent on that server.
- Create a Longview Client
- SSH into the Compute Instance
- Install the Longview Agent
- Start the Longview Agent
- View Longview Client Statistics
Log in to the Cloud Manager and click on the Longview link in the sidebar.
On the Longview Clients page, click on the Add a Client link on the top right-hand corner. This creates a Longview Client instance.
The new Longview Client instance is displayed along with its auto-generated label, its current status, installation instructions, and API key. Its status should be “Waiting for data” as you have not yet installed the Longview agent on your Linux system.The displayed
curlcommand is used in the next section to install the Longview agent on the desired Linux system. The long string appended to the url
https://lv.linode.com/is your Longview Client instance’s GUID (globally unique identifier).
Open a terminal on your local computer and log in to your Compute Instance (or other Linux system) over SSH. In the command below, replace [user] with your remote username and [ip-address] with the IP address or fully qualified domain name of your instance. See Managing IP Addresses on a Compute Instance.
Switch to the
su - root
Run the Longview Client instance’s
curl command on your Linux system. The installation will take a few minutes to complete.
curl command below with your own Longview Client instance’s GUID.
curl -s https://lv.linode.com/05AC7F6F-3B10-4039-9DEE09B0CC382A3D | sudo bash
Lock error: This likely means that another program is attempting to update or install packages on your system. To overcome this error, you can delete the current Longview Client, wait a few minutes, create a new Longview Client, and try the installation process again.
E: Could not get lock /var/lib/dpkg/lock-frontend. It is held by process 12549 (apt-get) N: Be aware that removing the lock file is not a solution and may break your system. E: Unable to acquire the dpkg frontend lock (/var/lib/dpkg/lock-frontend), is another process using it?
Invaliad installer session error: To overcome this error, delete the current Longview Client, create a new one, and try to install the Longview Agent again.
Invalid Installer Session Please see the Longview details page to start a new session
If you are not able to overcome these error messages, follow the manual installation instructions below.
If the automatic installation instructions failed, you can also manually install the Longview Agent on CentOS, Debian, and Ubuntu. Other distributions, like Fedora and Alpine Linux, are not officially supported.
Add a configuration file to store the repository information for the Longview agent:
Download the repository’s GPG key and import or move it to the correct location:
Create a directory for the API key:
sudo mkdir /etc/linode/
Copy the API key from the Installation tab of your Longview client’s detailed view in the Linode Cloud Manager. Put the key into a file, replacing the key in the command below with your own.
echo '266096EE-CDBA-0EBB-23D067749E27B9ED' | sudo tee /etc/linode/longview.key
Once the installation is complete, verify that the Longview agent is running:
sudo systemctl status longview
You should see a similar output:
If the Longview agent is not running, start it with the following command:
sudo systemctl start longview
Switch back to the Cloud Manager’s Longview Clients page in your browser and verify that system information and metrics have started to appear. To learn more about the metrics available on Longview, see Understanding Longview Metrics.
This page was originally published on