Prometheus & Grafana

Deploy Prometheus and Grafana, two open source tools used together to collect and view data. Optionally, you can also install Loki, a log aggregation system designed to work seamlessly with Grafana.

1. Deploy Prometheus & Grafana

 Estimated deployment time: 2–5 minutes

Base distribution and plan

• Supported distribution: Ubuntu 24.04 LTS
• Recommended plans: All plan types and sizes can be used.

Configuration options

StackScript ID: 985364

Notes:

• After the app deployment completes, the passwords for your limited sudo, Prometheus, Grafana, and Loki (if installed) users are generated and stored in the .credentials file in the home directory. Log in to your instance as root through the Lish console or SSH, then run cat /home/$USERNAME/.credentials to view its contents.
• You can automatically configure a custom domain (optional) during deployment. To do that:
  1. First, configure your domain to use Linode’s name servers via your registrar. See Configure your domain's authoritative name servers for details.
  2. Once you complete that, specify the Linode API token, subdomain, and domain for the app in Cloud Manager or via API/CLI/Terraform.

Use API, CLI, or Terraform

curl --location 'https://api.linode.com/v4/linode/instances' \
    --header 'Content-Type: application/json' \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer abc123def456hij789klm' \
    --data-raw '{
        "region": "us-east",
        "type": "g6-standard-2",
        "image": "linode/ubuntu24.04",
        "label": "my-prometheus-grafana-one-click-app",
        "root_pass": "@C0mpl3x#P@ssw0rd",
        "stackscript_id": 985364,
        "stackscript_data": {
            "user_name": "jsmith",
            "soa_email_address": "jsmith@example.com"
        }
    }'

linode-cli linodes create \
    --region us-east \
    --type g6-standard-2 \
    --label my-prometheus-grafana-one-click-app \
    --image linode/ubuntu24.04 \
    --root_pass @C0mpl3x#P@ssw0rd \
    --stackscript_id 985364 \
    --stackscript_data '{"user_name":"jsmith", "soa_email_address":"jsmith@example.com"}'

resource "linode_instance" "my-linode" {
    region         = "us-east"
    type           = "g6-standard-2"
    label          = "my-prometheus-grafana-one-click-app"
    image          = "linode/ubuntu24.04"
    root_pass      = "@C0mpl3x#P@ssw0rd"
    stackscript_id = 985364
    stackscript_data = {
        "user_name"         = "jsmith"
        "soa_email_address" ="jsmith@example.com"
    }
}

2. Access Prometheus & Grafana

Get credentials

To access the front-end interfaces for Grafana and Prometheus, you need to get the credentials from the server.

1. Once the app is fully deployed, log in to your Linode instance as a root user using either the Lish console or SSH.

2. After logging in, you can find the URLs and credential files listed in the motd (message of the day).

   CommandOutput

   cat /etc/motd

   *********************************************************
   Akamai Connected Cloud Prometheus & Grafana Quick Deploy App
   Grafana URL: https://$EXAMPLE_DOMAIN.COM
   Prometheus URL: https://$EXAMPLE_DOMAIN.COM/prometheus
   Credentials File: /home/$SUDO_USER/.credentials
   Documentation: https://techdocs.akamai.com/quick-deploy-apps/docs/prometheus-grafana
   *********************************************************

   To delete the motd, run rm /etc/motd.

3. Then run cat /home/$SUDO_USER/.credentials to see the file contents. It contains the credentials for the created limited sudo, Prometheus, Grafana, and Loki (if installed) users.

Add Prometheus as a data source to Grafana

1. Log in to the Grafana front end with your credentials.

2. On the main menu, hover over the gear icon to open the Configuration menu. Then select Data sources.

3. Within the Data sources tab, click the Add data source button.

4. Select Prometheus from the Time series database section of the Add data source page.

   A data source labeled Prometheus is automatically created, and its configuration settings are now visible.

5. Within the URL field, enter http://localhost:9090/prometheus. You can adjust the rest of the settings as needed.

   Now that the Prometheus data source is set, you can browse the available Grafana dashboards to see which dashboard fits your needs.

Configure Loki

If you installed Loki during deployment, it's automatically configured as a data source in Grafana.

To send logs from your applications and systems to Loki, install and configure a log collection agent, like Grafana Alloy, on the client systems.

Add Akamai Insights Data Source plug-in

If your Akamai account contract has Reporting enabled, you can take advantage of the Akamai Reporting API V2. This allows you to expose data to monitor traffic and analyze patterns and long-term trends directly in Grafana.

Before deploying the app, you need to have API client credentials. To learn how to create an API client for your Akamai account, see EdgeGrid authentication credentials.

To start using the plug-in:

1. During app deployment, enter your API client data into the corresponding fields. All fields are required to install the plug-in.

   • Akamai client_secret: Enter your client_secret.
   • Akamai host: Enter your Akamai host. This typically ends in luna.akamaiapis.net.
   • Akamai access_token: Enter your access_token.
   • Akamai client_token: Enter your client_token.

2. Once the app is deployed, log in to the Grafana front end.

3. On the main menu, hover over the gear icon to open the Configuration menu. Then select Data sources.

4. You should be able to find the akamai-insights-datasource option. Open it and click Save & test to check if the plug-in is working.

   If successful, you should see the Data source is working properly message.

Additional resources

For more information about the installed packages, see their official documentation.

• Prometheus Documentation
• Grafana Documentation