Prometheus: 4. Create the service

This documentation is part of the Automate with the CLI guide. You can view the complete guide here: Start Prometheus, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI.

👋 Welcome to the Stackhero documentation!

Stackhero offers a ready-to-use Prometheus cloud solution designed for reliability and simplicity:

• Alert Manager is included, allowing you to send alerts directly to Slack, Mattermost, PagerDuty, and other popular platforms.
• A dedicated email server enables you to send unlimited email alerts with no additional configuration required.
• Blackbox is provided, so you can probe HTTP, ICMP, TCP, and more for comprehensive monitoring.
• Simple configuration with the online configuration file editor—no need to manage YAML manually.
• Easy updates with just one click.
• Optimal performance and enhanced security thanks to your own private, dedicated VM.

Save time and make your life easier: it takes just 5 minutes to try Stackhero's Prometheus cloud hosting solution!

Below is an example script that creates a stack, adds your Prometheus service to it, waits for it to start, retrieves its configuration (including generated credentials), and then applies a new configuration.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="prometheus"   # The Prometheus service store name (see step 2)
instance="..."                # An instance size from step 3
region="europe"               # A region name from step 3

# Create a stack for your service (uses your default organisation; add --organization if needed)
stackId=$(stackhero --format=script stack-create \
  --name="My Prometheus stack")
echo "Stack created: ${stackId}"

# Add Prometheus to the stack (names are resolved automatically)
serviceId=$(stackhero --format=script service-add \
  --stack="My Prometheus stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service added: prometheus"

# Wait for the service to be fully operational (this may take a few minutes)
stackhero service-wait-for --service="prometheus"

# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="prometheus" --format=json