Deprecation Notice

This Docker image is deprecated, and will not receive further updates. Cortex v1.11.1 will be the final version published.

Cortex | Ubuntu

Current Cortex Docker Image from Canonical, based on Ubuntu. Receives security updates and tracks the newest combination of Cortex and Ubuntu. This repository is free to use and exempted from per-user rate limits.

About Cortex

Cortex provides horizontally scalable, highly available, multi-tenant, long term storage for Prometheus.

• Horizontally scalable: Cortex can run across multiple machines in a cluster, exceeding the throughput and storage of a single machine. This enables you to send the metrics from multiple Prometheus servers to a single Cortex cluster and run "globally aggregated" queries across all data in a single place.
• Highly available: When run in a cluster, Cortex can replicate data between machines. This allows you to survive machine failure without gaps in your graphs.
• Multi-tenant: Cortex can isolate data and queries from multiple different independent Prometheus sources in a single cluster, allowing untrusted parties to share the same cluster.
• Long term storage: Cortex supports Amazon DynamoDB, Google Bigtable, Cassandra, S3, GCS and Microsoft Azure for long term storage of metric data. This allows you to durably store data for longer than the lifetime of any single machine, and use this data for long term capacity planning.

Read more on the Cortex website.

Tags and Architectures

!LTS Up to 5 years free security maintenance on LTS channels.

!ESM Up to 10 years customer security maintenance from canonical/cortex. Request access.

Tags in italics are not available in ubuntu/cortex but are shown here for completeness.

Channel Tag shows the most stable channel for that track. A track is a combination of both the application version and the underlying Ubuntu series, eg 1.0-22.04. Channels are ordered from the most stable to the least stable, candidate, beta, edge. More risky channels are always implicitly available. So if beta is listed, you can also pull edge. If candidate is listed, you can pull beta and edge. When stable is listed, all four are available. Images are guaranteed to progress through the sequence edge, beta, candidate before stable.

Commercial use and Extended Security Maintenance channels

If your usage includes commercial redistribution or requires unavailable channels/versions, please get in touch with the Canonical team (or using ***).

Usage

Launch this image locally:

docker run -d --name cortex-container -e TZ=UTC -p 32709:9009 ubuntu/cortex:1.11-22.04_beta

Access your Cortex server at http://localhost:32709.

Parameters

Testing/Debugging

To debug the container:

docker logs -f cortex-container

To get an interactive shell:

docker exec -it cortex-container /bin/bash

Deploy with Kubernetes

Works with any Kubernetes; if you don't have one, we recommend you install MicroK8s and microk8s.enable dns storage then snap alias microk8s.kubectl kubectl.

Download cortex.yaml and cortex-deployment.yml and set containers.cortex.image in cortex-deployment.yml to your chosen channel tag (e.g. ubuntu/cortex:1.11-22.04_beta), then:

kubectl create configmap cortex-config --from-file=main-config=cortex.yaml
kubectl apply -f cortex-deployment.yml

You will now be able to connect to the Cortex server on localhost:32709.

Bugs and feature requests

If you find a bug in our image or want to request a specific feature, please file a bug here:

[***]

Please title the bug "cortex: <issue summary>". Make sure to include the digest of the image you are using, from:

docker images --no-trunc --quiet ubuntu/cortex:<tag>

Deprecated channels & tags

These channels (tags) are not updated anymore. Please upgrade to newer channels, or reach out if you can't upgrade.