https://github.com/projectcapsule/cortex-proxy

Proxy Cortex/Mimir organisations based on namespace ownership
https://github.com/projectcapsule/cortex-proxy

Last synced: about 1 year ago
JSON representation

Proxy Cortex/Mimir organisations based on namespace ownership

• Host: GitHub
• URL: https://github.com/projectcapsule/cortex-proxy
• Owner: projectcapsule
• License: mpl-2.0
• Created: 2025-03-01T00:13:32.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-06T20:06:59.000Z (about 1 year ago)
• Last Synced: 2025-05-06T21:23:37.321Z (about 1 year ago)
• Language: Go
• Size: 348 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# Capsule ❤️ Cortex

> [!IMPORTANT]

> This project is a permanent hard-fork of the [origin project](https://github.com/blind-oracle/cortex-tenant).

![Capsule Cortex](docs/images/logo.png)





  







  





 

 



Prometheus remote write proxy which marks timeseries with a Cortex/Mimir tenant ID based on labels.

## Overview

![Architecture](docs/images/capsule-cortex.gif)

Cortex/Mimir tenants (separate namespaces where metrics are stored to and queried from) are identified by `X-Scope-OrgID` HTTP header on both writes and queries.

This software solves the problem using the following logic:

- Receive Prometheus remote write

- Search each timeseries for a specific label name and extract a tenant ID from its value.

  If the label wasn't found then it can fall back to a configurable default ID.

  If none is configured then the write request will be rejected with HTTP code 400

- Optionally removes this label from the timeseries

- Groups timeseries by tenant

- Issues a number of parallel per-tenant HTTP requests to Cortex/Mimir with the relevant tenant HTTP header (`X-Scope-OrgID` by default)

## Documentation

See the [Documentation](docs/README.md) for more information on how to use this addon.

## Support

This addon is developed by the community. For enterprise support (production ready setup,tailor-made features) reach out to [Capsule Supporters](https://projectcapsule.dev/support/)

## License

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fprojectcapsule%2Fcortex-proxy.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fprojectcapsule%2Fcortex-proxy?ref=badge_large)