Skip to content

Kubernetes Prometheus Stack

Kubernetes Prometheus Stack

Category: Monitoring Type: Cluster Service Tags: prometheus · grafana · alertmanager · dashboard Bundle: Orion Essentials

Overview

The Kubernetes Prometheus Stack deploys the full Prometheus monitoring ecosystem into your cluster — including Prometheus for metrics collection, Grafana for visualization and dashboards, and Alertmanager for alerting. This is the standard observability stack used in production Kubernetes environments, pre-configured with Kubernetes-specific dashboards and service monitors that immediately begin collecting cluster metrics upon installation.

How It Works

Cluster Service — Installed once per cluster by an administrator. Once active, Prometheus begins collecting metrics from the entire cluster and Grafana is immediately available at the configured URL — no per-project installation needed.

Prerequisites

  • A DNS record pointing to your cluster's ingress controller for the Grafana host
  • An nginx ingress controller configured in the cluster
  • Sufficient cluster resources — Prometheus and its components have non-trivial memory requirements in larger clusters

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Kubernetes Prometheus Stack"
  3. Click Install
  4. Fill in the configuration fields below
  5. Click Confirm to deploy

Configuration

Install-Time Fields

Field Details
username string · Required
Grafana admin username
password string · Required
Grafana admin password
host string · Required
Hostname for the Grafana dashboard (e.g. grafana.example.com). A DNS record pointing to your cluster's ingress must exist.
path string · Optional
URL sub-path for Grafana (e.g. /grafana) if serving under a sub-path

Juno Metrics Gatherer

Installing this plugin unlocks the Juno Metrics Gatherer — an Orion monitoring component that collects resource utilisation data across your running workloads and surfaces it in Grafana automatically.

Once the Prometheus Stack is installed, the Metrics Gatherer populates a built-in Workload Monitoring dashboard in Grafana, giving administrators visibility into cluster performance and resource consumption across projects and time periods. This dashboard is also surfaced directly in the Genesis admin console.

Full documentation: Juno Metrics Gatherer

Notes

  • This plugin is included in the Orion Essentials bundle — you can install the Prometheus Stack, Helios, and the ArgoCD Dashboard together in one step from Terra
  • The Grafana admin credentials set here are the initial login credentials — you can create additional users within Grafana after installation
  • Prometheus scrapes metrics from all namespaces and includes pre-built Kubernetes dashboards for nodes, pods, deployments, and cluster health
  • Alertmanager can be configured within Grafana to send alerts to Slack, PagerDuty, email, and other destinations
  • This is a resource-intensive stack — monitor cluster node capacity before installing on smaller clusters
plugins/kube-prometheus-stack/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
resource_id: kube-prometheus-stack
name: Kubernetes Prometheus Stack
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/kube-prometheus-stack/assets/logo.png
description: Full Prometheus monitoring stack
category: Monitoring
tags:
  - prometheus
  - grafana
  - alertmanager
  - cluster-level
  - dashboard
fields:
  - name: username
    description: Admin username
    required: true
  - name: password
    description: Admin password
    required: true
  - name: host
    description: Connection URL. i.e. `grafana.example.com`. Keep in mind you must set up a DNS record for this host to point to your cluster's ingress controller.
    required: true
  - name: path
    description: Connection URL sub path. i.e. `grafana.example.com/my/path/grafana`.
    required: false