Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@
/k8s-cpu/ @BeverlyJaneJ
/k8s-mem/ @BeverlyJaneJ
/kafka-monitoring-lj/ @tacole02
/labeling-strategy-lj/ @Eve832
/linux-server-integration-lj/ @chri2547
/logql-101/ @nicolevanderhoeven
/macos-integration-lj/ @chri2547
Expand Down
90 changes: 90 additions & 0 deletions labeling-strategy-lj/assets/images/label-multiplication.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
60 changes: 60 additions & 0 deletions labeling-strategy-lj/assets/images/log-stream-splitting.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
56 changes: 56 additions & 0 deletions labeling-strategy-lj/assets/images/series-anatomy.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 42 additions & 0 deletions labeling-strategy-lj/assets/images/unbounded-label-growth.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
21 changes: 21 additions & 0 deletions labeling-strategy-lj/business-value/content.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"id": "labeling-strategy-business-value",
"title": "Understand the business value",
"blocks": [{
"type": "markdown",
"content": "Labeling decisions are made at instrumentation time but billed at ingestion time, and there is often no way to easily determine the cost impact of those decisions. A team that enables a monitoring integration with all its defaults can multiply its telemetry volume overnight, because every combination of label values creates another unique series or stream to store and pay for."
Comment thread
Eve832 marked this conversation as resolved.
},
{
"type": "markdown",
"content": "This pattern is one of the most common causes of unexpected billing spikes: a team with a fixed monthly observability budget turns everything on, sends thousands of metrics it never queries, and exceeds its contract in a fraction of the expected time. The root cause is rarely one bad decision. It's the compounding effect of labels not chosen with deliberation."
},
{
"type": "markdown",
"content": "A deliberate labeling strategy protects three things:\n\n- **Cost**: fewer unique label combinations means fewer active series and streams to pay for.\n- **Performance**: smaller indexes and fewer streams mean faster queries.\n- **Clarity**: labels chosen on purpose make your telemetry easier to navigate and attribute to teams."
},
{
"type": "markdown",
"content": "This path gives you the mental model first, then the hands-on tools; you'll see the cardinality math, inspect your own stack, and learn the decision frameworks for metrics and logs."
}
]
}
17 changes: 17 additions & 0 deletions labeling-strategy-lj/business-value/manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"id": "labeling-strategy-business-value",
"type": "guide",
"description": "Learn why a deliberate labeling strategy protects your Grafana Cloud costs, query performance, and telemetry clarity.",
"category": "take-action",
"author": {
"name": "Eve832",
"team": "Grafana Documentation"
},
"testEnvironment": {
"tier": "cloud"
},
"depends": [],
"recommends": ["labeling-strategy-understand-cardinality"],
"suggests": [],
"provides": []
}
12 changes: 12 additions & 0 deletions labeling-strategy-lj/business-value/website.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
menuTitle: Business value
weight: 100
step: 2
layout: single-journey
cta:
type: continue
keywords:
- labels
- cardinality
- cost-optimization
- business-value
description: Learn why a deliberate labeling strategy protects your Grafana Cloud costs, query performance, and telemetry clarity.
Loading
Loading