Skip to content

Commit 10ee9bf

Browse files
committed
Better wording for routing
1 parent 9632b3a commit 10ee9bf

File tree

2 files changed

+13
-8
lines changed

2 files changed

+13
-8
lines changed

content/en/ninja-workshops/10-advanced-otel/8-routing-data/8-1-connector.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,10 @@ In this exercise, you will configure the `routing` connector in the `gateway.yam
88

99
{{% notice title="Exercise" style="green" icon="running" %}}
1010

11-
**Add the `routing` connector**: In the **Gateway** terminal window edit `gateway.yaml` and add the following below the `receivers:` and `processors:` stanzas and above the `exporters:` stanza:
11+
In OpenTelemetry configuration files, `connectors` have their own dedicated section, similar to receivers and processors.
12+
13+
**Add the `routing` connector**:
14+
In the **Gateway** terminal window edit `gateway.yaml` and add the following below the `receivers:` section and above the `processors:` section:
1215

1316
```yaml
1417
connectors:
@@ -21,9 +24,9 @@ connectors:
2124
pipelines: [traces/security] # Target pipeline
2225
```
2326
24-
In OpenTelemetry configuration files, `connectors` have their own dedicated section, similar to receivers and processors. This approach also applies to `metrics` and `logs`, allowing them to be routed based on attributes in `resourceMetrics` or `resourceLogs`.
27+
The rules above apply to traces, but this approach also applies to `metrics` and `logs`, allowing them to be routed based on attributes in `resourceMetrics` or `resourceLogs`.
2528

26-
**Configure `file:` exporters**: The `routing` connector requires separate targets for routing. Add two file exporters, `file/traces/security` and `file/traces/standard`, to ensure data is directed correctly:
29+
**Configure `file:` exporters**: The `routing` connector requires separate targets for routing. Add two file exporters, `file/traces/security` and `file/traces/standard`, to ensure data is directed correctly.
2730

2831
```yaml
2932
file/traces/standard: # Exporter for regular traces

content/en/ninja-workshops/10-advanced-otel/8-routing-data/8-2-pipelines.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,8 @@ weight: 2
88

99
**Add both the `standard` and `security` traces pipelines**:
1010

11-
1. **Standard pipeline**: This pipeline processes all spans that do not match the routing rule. Add it below the existing `traces:` pipeline, keeping the configuration unchanged for now:
11+
1. **Add the Standard pipeline**: This pipeline processes all spans that do not match the routing rule.
12+
This pipeline is using `routing` as its receiver. Place it below the existing `traces:` pipeline, keeping its configuration unchanged for now:
1213

1314
```yaml
1415
traces/standard: # Default pipeline for unmatched spans
@@ -22,7 +23,8 @@ weight: 2
2223
- file/traces/standard # File exporter for unmatched spans
2324
```
2425

25-
2. **Security pipeline**: This pipeline will handle all spans that match the routing rule:
26+
2. **Configure the Security pipeline**: This pipeline will handle all spans that match the routing rule.
27+
This also uses `routing` as its receiver. Add this below the Standard one:
2628

2729
```yaml
2830
traces/security: # New Security Traces/Spans Pipeline
@@ -38,9 +40,9 @@ weight: 2
3840

3941
**Update the `traces` pipeline to use routing**:
4042

41-
1. To enable `routing`, update the original `traces:` pipeline by adding `routing` as an exporter. This ensures all span data is sent through the routing connector for evaluation.
42-
43-
2. Remove all processors as these are now defined in the `traces/standard` and `traces/security` pipelines.
43+
1. To enable `routing`, update the original `traces:` pipeline by using `routing` as the only exporter.
44+
This ensures all span data is sent through the routing connector for evaluation.
45+
2. Remove all processors and replace it with an empty array []. These are now defined in the `traces/standard` and `traces/security` pipelines.
4446

4547
```yaml
4648
pipelines:

0 commit comments

Comments
 (0)