Skip to content

Commit 20615c7

Browse files
committed
Rework and consolidate OTLP configuration related pages
1 parent 3bea439 commit 20615c7

13 files changed

+334
-490
lines changed

Diff for: CONTRIBUTING.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ There are several ways you can contribute:
4343

4444
- If you wish to make documentation edits or add new
4545
documentation, follow our [documentation contribution guidelines](https://docs.newrelic.com/docs/style-guide/writing-guidelines/create-edit-content/#edit-doc).
46-
- If you'd like to to make code contributions, or make content contributions locally, follow the contribution guidelines below.
46+
- If you'd like to make code contributions, or make content contributions locally, follow the contribution guidelines below.
4747

4848
## Getting started
4949

@@ -63,7 +63,7 @@ The first time you build the site locally, it will take upwards of 20 minutes. T
6363

6464
### Dependencies
6565

66-
Node v16 is used in this project as specified in [.nvmrc](https://github.com/newrelic/developer-website/blob/master/.nvmrc).
66+
Node v18 is used in this project as specified in [.nvmrc](https://github.com/newrelic/developer-website/blob/master/.nvmrc).
6767

6868
### Unit tests
6969

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-attributes.mdx

-19
This file was deleted.

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-batching.mdx

-77
This file was deleted.

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-compression.mdx

-25
This file was deleted.

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-overview.mdx

-31
This file was deleted.

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-traces.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -158,4 +158,4 @@ NRQL query representation
158158

159159
The most important thing to notice with resource attributes is the potential difference in the size of the payload being sent compared to what is stored in NRDB. All resource attribute values will be applied to every span in the OTLP payload. The example above only shows a single span being sent but if the payload contained 100 spans, each one of them would have `process.command_line` and `service.name` applied to them.
160160

161-
For some Java based applications, the default `process.command_line` attribute can be thousands of characters long which may result in a significant and unexpected increase in billable bytes. If these resource attributes do not provide value they can be disabled by following the [OpenTelemetry and attribute lengths: Best Practices](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-attributes/)
161+
For some Java based applications, the default `process.command_line` attribute can be thousands of characters long which may result in a significant and unexpected increase in billable bytes. If these resource attributes do not provide value they can be disabled by following the [OpenTelemetry and attribute lengths: Best Practices](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-otlp/#attribute-limits)

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-versions.mdx

-43
This file was deleted.

Diff for: src/content/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-implementation-guide.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Next, it's time to deploy the OpenTelemetry Collector, which is recommended for
5353
Here are some tips on configuring the OpenTelemetry Collector:
5454

5555
* <DoNotTranslate>**Use the right endpoint**</DoNotTranslate>. It should be configured to export OTLP data to our endpoint. This is explained in [our docs on sending data from an OpenTelemetry Collector](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/get-started/opentelemetry-set-up-your-app/#review-settings).
56-
* <DoNotTranslate>**Avoided dropped data**</DoNotTranslate>.To avoid data being dropped, we recommend [truncating](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-best-practices-attributes) any attributes greater than 4095 characters in length. For an example of applying these practices, see [this collector config](https://github.com/newrelic/newrelic-opentelemetry-examples/tree/main/other-examples/collector/nr-config).
56+
* <DoNotTranslate>**Avoided dropped data**</DoNotTranslate>.To avoid data being dropped, we recommend [truncating](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/best-practices/opentelemetry-otlp/#attribute-limits) any attributes greater than 4095 characters in length. For an example of applying these practices, see [this collector config](https://github.com/newrelic/newrelic-opentelemetry-examples/tree/main/other-examples/collector/nr-config).
5757
* <DoNotTranslate>**Infrastructure**</DoNotTranslate>. To collect infrastructure metrics, include the [host metrics receiver](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/collector/opentelemetry-collector-infra-hosts) in the collector config. When using the host receiver as part of the collector configuration, we automatically detect host metrics as part of a host entity and synthesize its golden metrics (in short, you get the same experience as you would with our infrastructure agent).
5858
* <DoNotTranslate>**Scaling**</DoNotTranslate>. Large OpenTelemetry deployments will need to choose a strategy for scaling the collector, both for performance and resiliency benefits. For details on scaling the collector, see [the OpenTelemetry docs](https://opentelemetry.io/docs/collector/scaling).
5959
* <DoNotTranslate>**Kubernetes**</DoNotTranslate>.If your OpenTelemetry-instrumented services are running in a Kubernetes environment, follow the steps in [Link OpenTelemetry-instrumented applications to Kubernetes](/docs/kubernetes-pixie/kubernetes-integration/advanced-configuration/link-otel-applications-kubernetes). This ensures that your Kubernetes data will be correlated with OpenTelemetry data.
@@ -114,7 +114,7 @@ For more tips on alerting:
114114

115115
New Relic [workloads](/docs/new-relic-solutions/new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) let you group related entities, providing aggregated health and activity data from frontend to backend services across your entire stack. Workloads help you [understand the status of complex systems](/docs/new-relic-solutions/new-relic-one/workloads/use-workloads), [detect issues](/docs/new-relic-solutions/new-relic-one/workloads/workload-status-views-notifications), understand the cause and impact of an incident, and resolve those issues quickly.
116116

117-
We recommend creating workloads to group OpenTelemetry services together with related entities. This could include entities monitored by our infrastructure monitoring, <InlinePopover type="apm" />, Kubernetes monitoring, <InlinePopover type="browser" />, and other entities. Workloads help you group entities into more manageable chunks, typically aligned with the teams responsible for those entities. This is especially valuable for large environments, which might have thousands of monitored entities.
117+
We recommend creating workloads to group OpenTelemetry services together with related entities. This could include entities monitored by our infrastructure monitoring, <InlinePopover type="apm" />, Kubernetes monitoring, <InlinePopover type="browser" />, and other entities. Workloads help you group entities into more manageable chunks, typically aligned with the teams responsible for those entities. This is especially valuable for large environments, which might have thousands of monitored entities.
118118

119119
Creating workloads unlocks other valuable features in New Relic, such as [errors inbox](/docs/errors-inbox/errors-inbox). With errors inbox, your teams can proactively detect, triage, and take action on all errors before they impact your customers. Errors are intelligently grouped to cut down on noise and ensure that critical errors are detected quickly and efficiently. This allows your team to resolve errors from across your stack, including errors from APM, browser (RUM), mobile, serverless (AWS Lambda) data, and OpenTelemetry, displayed on one screen.
120120

0 commit comments

Comments
 (0)