Linode Managed is a 24/7 incident response and system maintenance service. This robust, multi-homed monitoring system distributes monitoring checks to ensure that your servers remain online and available at all times. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. Once you add a service to Linode Managed, we'll monitor it for connectivity, response, and total request time. This guide shows you how to start monitoring your services with Linode Managed.
First, you'll need to sign up for Linode Managed. Once Linode Managed is enabled for your account, you'll see the Managed tab when you log in to the Linode Manager, as shown below. You'll use this interface to interact with Linode Managed and monitor your servers.
You'll need to perform several of the tasks outlined in this guide to start using Linode Managed:
Once you've completed these steps, you'll have successfully configured Linode Managed.
Misconfiguration of Linode Managed could prevent us from properly monitoring your services, resolving incidents when they are detected, or contacting you when an incident is detected.
To take full advantage of Linode Managed, you should upload credentials to your server and the Linode Manager website. This will allow our support staff to log in to your servers and access your services when an issue is detected.
Linode provides a public SSH key that you can add to your server. Install the key, and our support staff will be able to log in to your server as root or another user. This is an important component of the Linode Managed service - you should add Linode's public key to all of your servers.
First, copy the public key to your computer's clipboard. Here's how:
Log in to the Linode Manager.
Click the Managed tab.
Click the Credentials tab. The webpage shown below appears.
Copy Linode's public key to your clipboard.
Now that you've copied the public key, you need to install it on your server. There are two ways to install the public key: As the root user, or as another non-root user.
Installing the public SSH key for the root user is the easiest way to add Linode's public key to your server. However, if your server's SSH configuration doesn't allow root login, you may want to skip to the next section to add the public key to another user's account.
Here's how to install Linode's SSH key for the root user:
Open a terminal window and log in to your Linode via SSH.
Log in as root by entering the following command:
If you followed the instructions in the Securing Your Server guide to disable root login via SSH, you will need to reenable that feature to install the public key for the root user. Follow these instructions to edit the sshd_config file and reenable root login via SSH.
Open the authorized_keys file for editing by entering the following command:
Paste Linode's public key in to the file.
Save the changes to the authorized_keys file by pressing Control-X, and then Y.
You have successfully added Linode's public key for the root user. Repeat this process on every Linode you want to monitor with Linode Managed.
You can also install Linode's public SSH key for another non-root user. This allows you to disable SSH root login and still allow our support staff to log in to your servers.
Here's how to install Linode's SSH key as a non-root user:
Open a terminal window and log in to your Linode via SSH.
If you haven't already created a non-root user on your server, you should do so now. See Adding a New User for instructions. Make sure you add the user to the admin group.
Open the sudoers file for editing by entering the following command:
Type i to enter insert mode.
In the User privilege specification section of the file, add the following line, replacing example_user with your user name:
# User privilege specification example_user ALL=(ALL) NOPASSWD: ALL
Make sure this user is not in any groups that are in /etc/sudoers, as this may override the passwordless sudo setting.
You have successfully added Linode's public key for the user. Repeat this process on every Linode you want to monitor with Linode Managed.
To allow our support staff to log in to your servers when an issue is detected, you'll need to specify the SSH settings for each of your Linodes. Here's how to add the SSH settings to Linode Managed:
From the Managed tab, click the Linodes tab. The webpage shown below appears.
From the SSH Access menu, select Enabled. If this setting is selected, the Linode Managed team will log in to your server when an issue is detected.
Enter a username in the SSH User field. The specified user needs to have Linode's public SSH key installed. For instructions, see Adding the Public Key.
From the SSH IP menu, select a public IP address that the Linode Managed team can use to reach your Linode via SSH.
In the SSH Port field, enter the Linode's SSH port. The default port is 22.
Repeat steps 1-5 for all of your other Linodes.
Click Update settings to save your settings.
You have successfully added the SSH settings for your Linodes. The Linode Managed team can now log in to your servers when an issue is detected.
Many of the services running on your server can only be accessed with the appropriate username and password combination. To provide Linode's staff with access to those services, you should add credentials for the services to Linode Managed. All credentials are securely stored in our encrypted database.
Here's how to add a service credential to Linode Managed:
From the Managed tab, click the Credentials tab. The webpage shown below appears.
Select the Add an Account Credential link. The webpage shown below appears.
In the Label field, enter a descriptive name for the credential. For example, if you are entering the MySQL root password, you might enter "MySQL Root".
In the Optional User Name field, enter a username for the credential.
In the Password/Passphrase field, enter the password or passphrase for the credential.
Click Save Changes.
You have successfully added the credential to Linode Managed. You'll select the credential later, when you add a new service to be monitored.
Linode Managed allows you to specify contacts that will be contacted if an issue is detected with one of your services. Contacts are categorized in to groups and linked to specific services. The idea is to create separate groups for the administrators responsible for your different services and systems. For example, you could add all of your database administrators to a group called DBAs and then link that group to your MySQL service. That way, when Linode Managed detects an issue with MySQL, all of your database administrators will be notified at the same time.
Here's how to add a contact to Linode Managed:
From the Managed tab, click the Contacts tab. The webpage shown below appears.
Select the Add a Contact link. The webpage shown below appears.
In the Name field, enter the individual's name.
In the Email field, enter the individual's email address.
Enter the individual's phone numbers in the Phone 1 and Phone 2 fields. We may call the individual if we need additional information to troubleshoot an issue on your servers.
In the Group field, enter a group name. As described at the beginning of this section, groups can hold multiple contacts. Ideally, you'll combine all of the individuals responsible for a particular service or system into one group.
This is a required field, so even if you're the only user on the account, you'll still need to create a group for yourself.
You have successfully added an contact to Linode Managed. You'll select the contact groups later, when you add a new service to be monitored.
Linode Managed monitors the services running on your Linodes. Setting up services is an essential step in the configuration process - Linode Managed can't monitor anything until you add services to be monitored.
Here's how to add a new service to Linode Managed:
From the Managed tab, click the Monitoring tab. The webpage shown below appears.
Select the Add a Service to Monitor link. The webpage shown below appears.
Enter a label for your service in the Label field. Being descriptive will help our team fix the service if it becomes unavailable.
Optional: Select a group name from the Consult with menu to ensure that Linode can contact you or members of your team if we need help fixing this service.
From the Monitor Type menu, select URL to monitor a website or TCP Connection to monitor a service running on your Linode.
If you selected URL from the Monitor Type menu, enter a URL in the URL field. If you selected TCP Connection enter the TCP address and, optionally, a port number in the TCP field.
Optional: Enter a string in the Response body match field to automatically check for the string in the URL or TCP response.
In the Response timeout field, enter the time (in seconds) for the request to timeout if it does not receive a response.
In the Notes field, add any notes or additional information about this service. The more information we have about the service and how it's configured
Optional: Select this checkbox to indicate that you have copied Linode's public SSH key to your server. This step is optional, but highly recommended. If you do not copy our public key to your server, we will not be able to log in and troubleshoot issues.
Select a credential from the Link a Credential menu. See these instructions to learn how to add a credential for a service.
You can select and save more than one credential for a service.
You have successfully added a service to Linode Managed. We'll start monitoring the service in a couple minutes.
To help you get started, we've provided an example service monitoring configuration for the Apache web server. In this examine, Linode Managed will continuously monitor the URL provided to verify that the service is responding correctly. This is a great way to monitor the availability of a website.
Here are the example values:
Since Linode Managed continuously monitors your services for availability, you should temporarily disable monitoring for a service that you plan to modify. For example, you should disable monitoring for the Apache web server before modifying the Apache configuration file and restarting the service. Here's how to temporarily disable service monitoring:
From the Managed tab, click the Monitoring tab.
Find the service that you want to temporarily disable, and then select the Disable link. The dashboard will indicate that service's monitoring status is Disabled, as shown below.
The service is now temporarily disabled. Linode Managed won't resume monitoring this service until you reenable monitoring, as described in the next section.
When you're finished modifying the service, you'll need to reenable monitoring. Here's how to reenable monitoring for a disabled service:
From the Managed tab, click the Monitoring tab.
Find the disabled service, and then select the Enable link. The dashboard will indicate that the service's status is Pending, as shown below.
Linode Managed is now monitoring the service again. The service will be checked in a couple minutes - if it's available, the dashboard will indicate that the service's status is OK.
If you decide to remove or stop using a service on your Linode that is being monitored, you should also remove the service from Linode Managed. For example, you should remove the Apache service from Linode Managed if you decide to start using Linode as a dedicated database server. Here's how to remove services from Linode Managed so that they are no longer monitored:
Linode Managed has stopped actively monitoring the service.
This guide is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License.
Last edited by Sharon Campbell on Tuesday, January 14th, 2014 (r4081).