Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix docs: links to cross_link://docs/reference/ should go to cross_link://reference/ #2558

Merged
merged 1 commit into from
Feb 28, 2025
Merged
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
2 changes: 1 addition & 1 deletion docs/reference/log-correlation-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ This would print a log message along the lines of:
ERROR [trace.id=cd04f33b9c0c35ae8abe77e799f126b7 transaction.id=cd04f33b9c0c35ae] an error occurred
```

For log correlation to work, the trace ids must be extracted from the log message and stored in separate fields in the Elasticsearch document. This can be achieved by [parsing the data by using ingest node](beats://docs/reference/filebeat/configuring-ingest-node.md), in particular by using [the grok processor](elasticsearch://docs/reference/ingestion-tools/enrich-processor/grok-processor.md).
For log correlation to work, the trace ids must be extracted from the log message and stored in separate fields in the Elasticsearch document. This can be achieved by [parsing the data by using ingest node](beats://reference/filebeat/configuring-ingest-node.md), in particular by using [the grok processor](elasticsearch://reference/ingestion-tools/enrich-processor/grok-processor.md).

```json
{
Expand Down
4 changes: 2 additions & 2 deletions docs/reference/logs.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Elastic .NET Agent provides [Log correlation](#log-correlation-ids). The agent w

This features is part of [Application log ingestion strategies](docs-content://solutions/observability/logs/stream-application-logs.md).

The [`ecs-logging-dotnet`](ecs-dotnet://docs/reference/index.md) library can also be used to use the [ECS logging](ecs-logging://docs/reference/intro.md) format without an APM agent. ECS .NET logging will always provide [log correlation](#log-correlation-ids) IDs through [`System.Diagnostics.Activity`](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.activity?view=net-7.0). When paired with the APM Agent it will pick up the appropriate service correlation features too.
The [`ecs-logging-dotnet`](ecs-dotnet://reference/index.md) library can also be used to use the [ECS logging](ecs-logging://reference/intro.md) format without an APM agent. ECS .NET logging will always provide [log correlation](#log-correlation-ids) IDs through [`System.Diagnostics.Activity`](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.activity?view=net-7.0). When paired with the APM Agent it will pick up the appropriate service correlation features too.


## Log correlation [log-correlation-ids]
Expand All @@ -24,7 +24,7 @@ If your favorite logging framework is not already supported, there are two other
* Open a feature request, or contribute code, for additional support, as described in [CONTRIBUTING.md](https://github.com/elastic/apm-agent-dotnet/blob/main/CONTRIBUTING.md).
* Manually inject trace IDs into log records, as described in [Manual log correlation](/reference/log-correlation-manual.md).

Regardless of how you integrate APM with logging, you can use [Filebeat](beats://docs/reference/filebeat/filebeat-overview.md) to send your logs to Elasticsearch, in order to correlate your traces and logs and link from APM to the [Logs app](docs-content://solutions/observability/logs/explore-logs.md).
Regardless of how you integrate APM with logging, you can use [Filebeat](beats://reference/filebeat/filebeat-overview.md) to send your logs to Elasticsearch, in order to correlate your traces and logs and link from APM to the [Logs app](docs-content://solutions/observability/logs/explore-logs.md).



Expand Down
2 changes: 1 addition & 1 deletion docs/reference/metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ For applications running in IIS, [IIS application pool identities use *virtual*
::::


For more system metrics, consider installing [metricbeat](beats://docs/reference/metricbeat/metricbeat.md) on your hosts.
For more system metrics, consider installing [metricbeat](beats://reference/metricbeat/metricbeat.md) on your hosts.

**`system.cpu.total.norm.pct`**
: type: scaled_float
Expand Down
4 changes: 2 additions & 2 deletions docs/reference/public-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -316,7 +316,7 @@ finally
Labels are used to add **indexed** information to transactions, spans, and errors. Indexed means the data is searchable and aggregatable in Elasticsearch. Multiple labels can be defined with different key-value pairs.

* Indexed: Yes
* Elasticsearch type: [object](elasticsearch://docs/reference/elasticsearch/mapping-reference/object.md)
* Elasticsearch type: [object](elasticsearch://reference/elasticsearch/mapping-reference/object.md)
* Elasticsearch field: `labels` (previously `context.tags` in <v.7.0)

Label values can be a string, boolean, or number. Because labels for a given key are stored in the same place in Elasticsearch, all label values of a given key must have the same data type. Multiple data types per key will throw an exception, e.g., `{"foo": "bar"}` and `{"foo": 42}`.
Expand Down Expand Up @@ -511,7 +511,7 @@ To enable the JavaScript RUM agent in ASP.NET Core, initialize the RUM agent wit
</script>
```

See the [JavaScript RUM agent documentation](apm-agent-rum-js://docs/reference/index.md) for more information.
See the [JavaScript RUM agent documentation](apm-agent-rum-js://reference/index.md) for more information.


#### `Dictionary<string,string> Custom` [api-transaction-custom]
Expand Down
Loading