Ryvn applies a set of standardized Kubernetes labels to all resources it manages. These labels help with observability, management, and troubleshooting by providing consistent metadata across your deployments.Documentation Index
Fetch the complete documentation index at: https://ryvn.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Core labels
All Ryvn-managed resources include the following labels:| Label | Description | Example |
|---|---|---|
ryvn.app/service-name | The name of the service | my-api |
app.kubernetes.io/managed-by | Indicates that Ryvn manages this resource | ryvn |
app.kubernetes.io/instance | The name of the installation | my-api-production |
app.kubernetes.io/name | The component name | web-server |
app.kubernetes.io/version | The version of the application | 1.2.3 |
ryvn.app/release-version | The specific release version deployed | 1.2.3 |
Using labels for observability
These labels are particularly useful when:- Filtering resources in Kubernetes dashboards - You can use these labels to filter and group resources in tools like Kubernetes Dashboard, Lens, or k9s.
- Setting up monitoring tools - Configure monitoring tools like Prometheus to collect metrics based on these labels.
- Debugging deployments - Quickly identify which version of your application is running in each environment.
- Creating custom views - Build custom dashboards that group resources by service, version, or other attributes.
Example: filtering by release version
If you have access to your Kubernetes cluster, you can use theryvn.app/release-version label to find all resources
running a specific version:
Example: monitoring version distribution
You can use these labels to monitor the distribution of versions across your environments, which is particularly useful during rolling updates:my-api service along with their labels, including which version each pod is running.
Integration with external tools
Many observability tools support Kubernetes label-based filtering and grouping:- Prometheus: Use label selectors in your scrape configurations
- Grafana: Create dashboards that filter metrics by service and version
- Datadog: Filter and group resources by Kubernetes labels
- New Relic: Use labels for filtering and creating custom views
The specific labels available may vary slightly depending on the service type (Server, Job, Chart, or Terraform).