From 5318f3fb501fc4efd8a303481b2942b2f1f0b9d8 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Thu, 21 Nov 2024 13:19:50 -0500 Subject: [PATCH 01/52] CI] Install packages before running fix:text (#5663) --- .github/workflows/pr-actions.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/pr-actions.yml b/.github/workflows/pr-actions.yml index a0ace66b4da5..0917cd66f6bb 100644 --- a/.github/workflows/pr-actions.yml +++ b/.github/workflows/pr-actions.yml @@ -69,7 +69,7 @@ jobs: - run: | case $PR_ACTION in - all|refcache) + all|refcache|text) npm install --omit=optional ;& *) From 7abc6c4ced3ba65536ac4885df20cc42b1c78d47 Mon Sep 17 00:00:00 2001 From: EkkoLee <40066683+EkkoLee98@users.noreply.github.com> Date: Fri, 22 Nov 2024 18:41:20 +0800 Subject: [PATCH 02/52] Update instrumentation.md (#5666) --- content/en/docs/languages/js/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/languages/js/instrumentation.md b/content/en/docs/languages/js/instrumentation.md index d1b42b809cb6..71103831b4f8 100644 --- a/content/en/docs/languages/js/instrumentation.md +++ b/content/en/docs/languages/js/instrumentation.md @@ -115,7 +115,7 @@ add the following code to it: ```ts /*app.ts*/ -import express, { Request, Express } from 'express'; +import express, { Express } from 'express'; import { rollTheDice } from './dice'; const PORT: number = parseInt(process.env.PORT || '8080'); From 2219eb440f45493580d6ad7b8b4b0f7a136a7c97 Mon Sep 17 00:00:00 2001 From: "John L. Peterson (Jack)" Date: Fri, 22 Nov 2024 05:45:51 -0500 Subject: [PATCH 03/52] add confmap provider to registry.json (#5637) Co-authored-by: Severin Neumann --- data/registry-schema.json | 1 + ...collector-confmap-provider-envprovider.yml | 22 +++++++++++++++++++ ...ollector-confmap-provider-fileprovider.yml | 21 ++++++++++++++++++ ...ollector-confmap-provider-httpprovider.yml | 21 ++++++++++++++++++ ...llector-confmap-provider-httpsprovider.yml | 21 ++++++++++++++++++ ...ollector-confmap-provider-yamlprovider.yml | 21 ++++++++++++++++++ static/refcache.json | 20 +++++++++++++++++ 7 files changed, 127 insertions(+) create mode 100644 data/registry/collector-confmap-provider-envprovider.yml create mode 100644 data/registry/collector-confmap-provider-fileprovider.yml create mode 100644 data/registry/collector-confmap-provider-httpprovider.yml create mode 100644 data/registry/collector-confmap-provider-httpsprovider.yml create mode 100644 data/registry/collector-confmap-provider-yamlprovider.yml diff --git a/data/registry-schema.json b/data/registry-schema.json index c605d190742c..7a9683e14f6b 100644 --- a/data/registry-schema.json +++ b/data/registry-schema.json @@ -17,6 +17,7 @@ "description": "The type of the entry", "enum": [ "application integration", + "confmap provider", "core", "exporter", "extension", diff --git a/data/registry/collector-confmap-provider-envprovider.yml b/data/registry/collector-confmap-provider-envprovider.yml new file mode 100644 index 000000000000..4e131a434941 --- /dev/null +++ b/data/registry/collector-confmap-provider-envprovider.yml @@ -0,0 +1,22 @@ +# cSpell:ignore confmap, envprovider +title: Collector Environment Variable Provider +registryType: confmap provider +language: collector +tags: + - go + - confmap + - provider + - collector + - env +license: Apache 2.0 +description: + Environment variable provider for OpenTelemetry Collector configuration maps. +authors: + - name: OpenTelemetry Authors +urls: + repo: https://github.com/open-telemetry/opentelemetry-collector/tree/main/confmap/provider/envprovider +createdAt: 2024-11-20 +package: + registry: go-collector + name: go.opentelemetry.io/collector/confmap/provider/envprovider + version: v1.20.0 diff --git a/data/registry/collector-confmap-provider-fileprovider.yml b/data/registry/collector-confmap-provider-fileprovider.yml new file mode 100644 index 000000000000..66dc5336a89d --- /dev/null +++ b/data/registry/collector-confmap-provider-fileprovider.yml @@ -0,0 +1,21 @@ +# cSpell:ignore confmap, fileprovider +title: Collector File Provider +registryType: confmap provider +language: collector +tags: + - go + - confmap + - provider + - collector + - file +license: Apache 2.0 +description: File provider for OpenTelemetry Collector configuration maps. +authors: + - name: OpenTelemetry Authors +urls: + repo: https://github.com/open-telemetry/opentelemetry-collector/tree/main/confmap/provider/fileprovider +createdAt: 2024-11-20 +package: + registry: go-collector + name: go.opentelemetry.io/collector/confmap/provider/fileprovider + version: v1.20.0 diff --git a/data/registry/collector-confmap-provider-httpprovider.yml b/data/registry/collector-confmap-provider-httpprovider.yml new file mode 100644 index 000000000000..97794a9d6d48 --- /dev/null +++ b/data/registry/collector-confmap-provider-httpprovider.yml @@ -0,0 +1,21 @@ +# cSpell:ignore confmap, httpprovider +title: Collector HTTP Provider +registryType: confmap provider +language: collector +tags: + - go + - confmap + - provider + - collector + - http +license: Apache 2.0 +description: HTTP provider for OpenTelemetry Collector configuration maps. +authors: + - name: OpenTelemetry Authors +urls: + repo: https://github.com/open-telemetry/opentelemetry-collector/tree/main/confmap/provider/httpprovider +createdAt: 2024-11-20 +package: + registry: go-collector + name: go.opentelemetry.io/collector/confmap/provider/httpprovider + version: v1.20.0 diff --git a/data/registry/collector-confmap-provider-httpsprovider.yml b/data/registry/collector-confmap-provider-httpsprovider.yml new file mode 100644 index 000000000000..1e4fceb2083d --- /dev/null +++ b/data/registry/collector-confmap-provider-httpsprovider.yml @@ -0,0 +1,21 @@ +# cSpell:ignore confmap, httpsprovider +title: Collector HTTPS Provider +registryType: confmap provider +language: collector +tags: + - go + - confmap + - provider + - collector + - https +license: Apache 2.0 +description: HTTPS provider for OpenTelemetry Collector configuration maps. +authors: + - name: OpenTelemetry Authors +urls: + repo: https://github.com/open-telemetry/opentelemetry-collector/tree/main/confmap/provider/httpsprovider +createdAt: 2024-11-20 +package: + registry: go-collector + name: go.opentelemetry.io/collector/confmap/provider/httpsprovider + version: v1.20.0 diff --git a/data/registry/collector-confmap-provider-yamlprovider.yml b/data/registry/collector-confmap-provider-yamlprovider.yml new file mode 100644 index 000000000000..26cb39be235e --- /dev/null +++ b/data/registry/collector-confmap-provider-yamlprovider.yml @@ -0,0 +1,21 @@ +# cSpell:ignore confmap, yamlprovider +title: Collector YAML Provider +registryType: confmap provider +language: collector +tags: + - go + - confmap + - provider + - collector + - yaml +license: Apache 2.0 +description: YAML provider for OpenTelemetry Collector configuration maps. +authors: + - name: OpenTelemetry Authors +urls: + repo: https://github.com/open-telemetry/opentelemetry-collector/tree/main/confmap/provider/yamlprovider +createdAt: 2024-11-20 +package: + registry: go-collector + name: go.opentelemetry.io/collector/confmap/provider/yamlprovider + version: v1.20.0 diff --git a/static/refcache.json b/static/refcache.json index 8336adfe838d..98c5ec01aea4 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -11531,6 +11531,26 @@ "StatusCode": 200, "LastSeen": "2024-01-18T19:07:49.734386-05:00" }, + "https://pkg.go.dev/go.opentelemetry.io/collector/confmap/provider/envprovider": { + "StatusCode": 200, + "LastSeen": "2024-11-19T13:34:41.905691-05:00" + }, + "https://pkg.go.dev/go.opentelemetry.io/collector/confmap/provider/fileprovider": { + "StatusCode": 200, + "LastSeen": "2024-11-19T13:34:42.093539-05:00" + }, + "https://pkg.go.dev/go.opentelemetry.io/collector/confmap/provider/httpprovider": { + "StatusCode": 200, + "LastSeen": "2024-11-19T13:34:42.280695-05:00" + }, + "https://pkg.go.dev/go.opentelemetry.io/collector/confmap/provider/httpsprovider": { + "StatusCode": 200, + "LastSeen": "2024-11-19T13:34:42.965663-05:00" + }, + "https://pkg.go.dev/go.opentelemetry.io/collector/confmap/provider/yamlprovider": { + "StatusCode": 200, + "LastSeen": "2024-11-19T13:34:43.403526-05:00" + }, "https://pkg.go.dev/go.opentelemetry.io/collector/exporter/debugexporter": { "StatusCode": 200, "LastSeen": "2024-03-01T16:49:31.744795+01:00" From 37bab286a7edd9f616995b8be8c91d8714cfe049 Mon Sep 17 00:00:00 2001 From: victorhu Date: Fri, 22 Nov 2024 18:48:00 +0800 Subject: [PATCH 04/52] add rizhiyi lunaxee product by yottabyte in vendor list (#5660) --- data/ecosystem/vendors.yaml | 6 ++++++ static/refcache.json | 4 ++++ 2 files changed, 10 insertions(+) diff --git a/data/ecosystem/vendors.yaml b/data/ecosystem/vendors.yaml index 146c9e458f29..2d9edbffe246 100644 --- a/data/ecosystem/vendors.yaml +++ b/data/ecosystem/vendors.yaml @@ -451,3 +451,9 @@ contact: 'hello@groundcover.com' oss: false commercial: true +- name: rizhiyi lunaxee by Yottabyte + nativeOTLP: true + url: https://rizhiyi.com/lunaxee/ + contact: contact@rizhiyi.cn + oss: false + commercial: true diff --git a/static/refcache.json b/static/refcache.json index 98c5ec01aea4..88d2baf808ed 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -12075,6 +12075,10 @@ "StatusCode": 206, "LastSeen": "2024-01-30T16:14:42.741857-05:00" }, + "https://rizhiyi.com/lunaxee/": { + "StatusCode": 200, + "LastSeen": "2024-11-21T17:49:04.913463719+08:00" + }, "https://roadrunner.dev/": { "StatusCode": 200, "LastSeen": "2024-01-30T06:06:18.661054-05:00" From 65b7a320ea603bb7ad03ea1360dfaad5e228b7a3 Mon Sep 17 00:00:00 2001 From: Basirat Kareem <101411132+basiratkareem@users.noreply.github.com> Date: Fri, 22 Nov 2024 11:50:26 +0100 Subject: [PATCH 05/52] Implement clickable flag buttons to filter records without updating search term (#5611) Co-authored-by: Severin Neumann --- .../partials/ecosystem/registry/entry.html | 23 +++++++++++-------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/layouts/partials/ecosystem/registry/entry.html b/layouts/partials/ecosystem/registry/entry.html index 27b17cc83014..ba87a52671fc 100644 --- a/layouts/partials/ecosystem/registry/entry.html +++ b/layouts/partials/ecosystem/registry/entry.html @@ -1,9 +1,9 @@ {{ $languageNames := .languageNames -}} {{ with .value -}} - {{ + {{ $remoteRegistries := dict - "npm" (dict + "npm" (dict "urlPattern" "https://npmjs.com/package/%s" "installTemplate" "ecosystem/registry/quickinstall/default.md" "installLine" "npm install %s" @@ -116,16 +116,19 @@

new {{ end -}} {{ if $isNative -}} - native + + native {{ end -}} {{ if $isFirstParty -}} - first party integration + + first party integration {{ end -}} {{ if $usedInDemo -}} OTel Demo {{ end -}} {{ if $deprecated -}} - deprecated + + deprecated {{ end -}} {{ if .cncfProjectLevel -}} @@ -136,7 +139,7 @@

- by + by {{ range $index, $author := .authors -}} {{ if $index }}, {{ end }} {{ if eq $author.name "OpenTelemetry Authors" -}} @@ -191,7 +194,7 @@

Quick Install
{{ .package.version }} Version - + {{- end -}} {{ with .language -}} @@ -201,7 +204,7 @@
Quick Install
{{ $languageNames.Get . | default (humanize .) }} Language - + {{- end }} {{ with .registryType -}} @@ -211,7 +214,7 @@
Quick Install
{{ . | humanize }} Component - + {{- end -}} {{ with .license -}} @@ -221,7 +224,7 @@
Quick Install
{{ . }} License - + {{- end -}} From fb627151d3bf04f009cf7040d431851f5637c9d6 Mon Sep 17 00:00:00 2001 From: EkkoLee <40066683+EkkoLee98@users.noreply.github.com> Date: Fri, 22 Nov 2024 21:40:16 +0800 Subject: [PATCH 06/52] Update browser.md (#5667) --- content/en/docs/languages/js/getting-started/browser.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/content/en/docs/languages/js/getting-started/browser.md b/content/en/docs/languages/js/getting-started/browser.md index 94b41b3c4cdc..d5915e6e5faa 100644 --- a/content/en/docs/languages/js/getting-started/browser.md +++ b/content/en/docs/languages/js/getting-started/browser.md @@ -166,8 +166,9 @@ import { DocumentLoadInstrumentation } from '@opentelemetry/instrumentation-docu import { ZoneContextManager } from '@opentelemetry/context-zone'; import { registerInstrumentations } from '@opentelemetry/instrumentation'; -const provider = new WebTracerProvider(); -provider.addSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter())); +const provider = new WebTracerProvider({ + spanProcessors: [new SimpleSpanProcessor(new ConsoleSpanExporter())], +}); provider.register({ // Changing default contextManager to use ZoneContextManager - supports asynchronous operations - optional From e4716bd00854eb2b2678ab0e647dd0dae26c0d54 Mon Sep 17 00:00:00 2001 From: Pierre Tessier Date: Fri, 22 Nov 2024 08:40:37 -0500 Subject: [PATCH 07/52] [demo] - clarify demo upgrade capability in Kubernetes (#5655) Co-authored-by: Juliano Costa Co-authored-by: Tiffany Hrabusa <30397949+tiffany76@users.noreply.github.com> Co-authored-by: Severin Neumann --- content/en/docs/demo/kubernetes-deployment.md | 71 +++++++++++-------- 1 file changed, 43 insertions(+), 28 deletions(-) diff --git a/content/en/docs/demo/kubernetes-deployment.md b/content/en/docs/demo/kubernetes-deployment.md index b6a5ddb494ef..dbaddf428ee1 100644 --- a/content/en/docs/demo/kubernetes-deployment.md +++ b/content/en/docs/demo/kubernetes-deployment.md @@ -32,8 +32,20 @@ command: helm install my-otel-demo open-telemetry/opentelemetry-demo ``` -> **Note** The OpenTelemetry Demo Helm chart version 0.11.0 or greater is -> required to perform all usage methods mentioned below. +{{% alert title="Note" color="info" %}} + +The OpenTelemetry Demo Helm chart does not support being upgraded from one +version to another. If you need to upgrade the chart, you must first delete the +existing release and then install the new version. + +{{% /alert %}} + +{{% alert title="Note" color="info" %}} + +The OpenTelemetry Demo Helm chart version 0.11.0 or greater is required to +perform all usage methods mentioned below. + +{{% /alert %}} ## Install using kubectl @@ -44,8 +56,20 @@ cluster. kubectl apply --namespace otel-demo -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-demo/main/kubernetes/opentelemetry-demo.yaml ``` -> **Note** These manifests are generated from the Helm chart and are provided -> for convenience. It is recommended to use the Helm chart for installation. +{{% alert title="Note" color="info" %}} + +The OpenTelemetry Demo Kubernetes manifests do not support being upgraded from +one version to another. If you need to upgrade the demo, you must first delete +the existing resources and then install the new version. + +{{% /alert %}} + +{{% alert title="Note" color="info" %}} + +These manifests are generated from the Helm chart and are provided for +convenience. It is recommended to use the Helm chart for installation. + +{{% /alert %}} ## Use the Demo @@ -63,10 +87,14 @@ To expose the frontendproxy service use the following command (replace kubectl port-forward svc/my-otel-demo-frontendproxy 8080:8080 ``` -> **Note**: `kubectl port-forward` will proxy the port until the process -> terminates. You may need to create separate terminal sessions for each use of -> `kubectl port-forward`, and use Ctrl-C to terminate the process -> when done. +{{% alert title="Note" color="info" %}} + +`kubectl port-forward` proxies the port until the process terminates. You might +need to create separate terminal sessions for each use of +`kubectl port-forward`, and use Ctrl-C to terminate the process when +done. + +{{% /alert %}} With the frontendproxy port-forward set up, you can access: @@ -84,9 +112,13 @@ options. {{% /alert %}} #### Configure ingress resources -> **Note** Kubernetes clusters may not have the proper infrastructure components -> to enable LoadBalancer service types or ingress resources. Verify your cluster -> has the proper support before using these configuration options. +{{% alert title="Note" color="info" %}} + +Kubernetes clusters might not have the proper infrastructure components to +enable LoadBalancer service types or ingress resources. Verify your cluster has +the proper support before using these configuration options. + +{{% /alert %}} Each demo component (ie: frontendproxy) offers a way to have its Kubernetes service type configured. By default, these will not be created, but you can @@ -144,23 +176,6 @@ components: value: http://otel-demo.my-domain.com/otlp-http/v1/traces ``` -#### Installation with a values file - -To install the Helm chart with a custom `my-values-file.yaml` values file use: - -```shell -helm install my-otel-demo open-telemetry/opentelemetry-demo --values my-values-file.yaml -``` - -With the frontendproxy and Collector exposed, you can access the demo UI at the -base path for the frontendproxy. Other demo components can be accessed at the -following sub-paths: - -- Web store: `/` (base) -- Grafana: `/grafana` -- Load Generator UI: `/loadgen/` (must include trailing slash) -- Jaeger UI: `/jaeger/ui` - ## Bring your own backend Likely you want to use the web store as a demo application for an observability From a0935d81c5d7025eaa5a0330c4e7039623b607c0 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Sat, 23 Nov 2024 09:06:24 -0500 Subject: [PATCH 08/52] [CI] Patch search results page so search results will display (#5675) --- package.json | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/package.json b/package.json index 4b18d20f3a6a..c2f74763de4c 100644 --- a/package.json +++ b/package.json @@ -23,6 +23,7 @@ "_filename-error": "echo 'ERROR: the following files violate naming conventions; fix using: `npm run fix:filenames`'; echo; npm run -s _ls-bad-filenames; exit 1", "_get:no": "echo SKIPPING get operation", "_get:submodule": "set -x && git submodule update --init ${DEPTH:- --depth 999}", + "_hugo-0_139_0_gcse-patch": "perl -i -pe 's/gcse :/gcse:/' public/search/index.html", "_hugo": "hugo --cleanDestinationDir", "_install:dict": "npm install -D $(npm run -s _list:dict)", "_install:netlify-cli": "npm list netlify-cli || npm install -O netlify-cli", @@ -94,6 +95,8 @@ "prepare": "npm run seq -- get:submodule _prepare:docsy", "preserve:hugo": "npm run _prebuild", "preserve:netlify": "npm run seq -- _prebuild _install:netlify-cli", + "postbuild:preview": "npm run _hugo-0_139_0_gcse-patch", + "postbuild:production": "npm run _hugo-0_139_0_gcse-patch", "schemas:update": "npm run update:submodule content-modules/opentelemetry-specification", "seq": "bash -c 'for cmd in \"$@\"; do npm run $cmd || exit 1; done' - ", "serve:hugo": "npm run _serve:hugo -- --renderToMemory", @@ -139,7 +142,7 @@ "@opentelemetry/resources": "^1.28.0", "@opentelemetry/sdk-trace-base": "^1.28.0", "@opentelemetry/sdk-trace-web": "^1.28.0", - "@opentelemetry/semantic-conventions": "^1.27.0", + "@opentelemetry/semantic-conventions": "^1.28.0", "path": "^0.12.7" }, "optionalDependencies": { From e5402a44a6291107bb26337da6f89962a6c64a8a Mon Sep 17 00:00:00 2001 From: Juliano Costa Date: Mon, 25 Nov 2024 11:41:11 +0100 Subject: [PATCH 09/52] [Demo] Update diagram (#5678) Co-authored-by: Mikko Viitanen <74129181+mviitane@users.noreply.github.com> --- content/en/docs/demo/architecture.md | 61 ++++++++++++++++------------ 1 file changed, 36 insertions(+), 25 deletions(-) diff --git a/content/en/docs/demo/architecture.md b/content/en/docs/demo/architecture.md index ab2f2040807b..245ff539c225 100644 --- a/content/en/docs/demo/architecture.md +++ b/content/en/docs/demo/architecture.md @@ -14,12 +14,13 @@ graph TD subgraph Service Diagram accountingservice(Accounting Service):::dotnet adservice(Ad Service):::java -cache[(Cache
(redis))] +cache[(Cache
(Valkey))] cartservice(Cart Service):::dotnet checkoutservice(Checkout Service):::golang currencyservice(Currency Service):::cpp emailservice(Email Service):::ruby -flagd(Flagd-ui):::typescript +flagd(Flagd):::golang +flagdui(Flagd-ui):::typescript frauddetectionservice(Fraud Detection Service):::kotlin frontend(Frontend):::typescript frontendproxy(Frontend Proxy
(Envoy)):::cpp @@ -30,40 +31,52 @@ productcatalogservice(Product Catalog Service):::golang quoteservice(Quote Service):::php recommendationservice(Recommendation Service):::python shippingservice(Shipping Service):::rust -queue[(queue
(Kafka))] +queue[(queue
(Kafka))]:::java -Internet -->|HTTP| frontendproxy -frontendproxy -->|HTTP| frontend -frontendproxy -->|HTTP| flagd -loadgenerator -->|HTTP| frontendproxy -frontendproxy -->|HTTP| imageprovider +adservice ---->|gRPC| flagd -queue -->|TCP| accountingservice -queue -->|TCP| frauddetectionservice - -frontend -->|gRPC| cartservice -frontend -->|gRPC| currencyservice +checkoutservice -->|gRPC| cartservice +checkoutservice --->|TCP| queue +cartservice --> cache +cartservice -->|gRPC| flagd -checkoutservice -->|gRPC| cartservice --> cache -checkoutservice -->|gRPC| productcatalogservice -checkoutservice -->|gRPC| currencyservice -checkoutservice -->|HTTP| emailservice -checkoutservice -->|gRPC| paymentservice checkoutservice -->|gRPC| shippingservice -checkoutservice -->|TCP| queue +checkoutservice -->|gRPC| paymentservice +checkoutservice --->|HTTP| emailservice +checkoutservice -->|gRPC| currencyservice +checkoutservice -->|gRPC| productcatalogservice + +frauddetectionservice -->|gRPC| flagd frontend -->|gRPC| adservice +frontend -->|gRPC| cartservice +frontend -->|gRPC| checkoutservice +frontend ---->|gRPC| currencyservice +frontend ---->|gRPC| recommendationservice frontend -->|gRPC| productcatalogservice -frontend --->|gRPC| checkoutservice -frontend ---->|gRPC| recommendationservice -->|gRPC| productcatalogservice -shippingservice -->|HTTP| quoteservice +frontendproxy -->|gRPC| flagd +frontendproxy -->|HTTP| frontend +frontendproxy -->|HTTP| flagdui +frontendproxy -->|HTTP| imageprovider + +Internet -->|HTTP| frontendproxy + +loadgenerator -->|HTTP| frontendproxy + +paymentservice -->|gRPC| flagd +queue -->|TCP| accountingservice +queue -->|TCP| frauddetectionservice + +recommendationservice -->|gRPC| productcatalogservice +recommendationservice -->|gRPC| flagd + +shippingservice -->|HTTP| quoteservice end classDef dotnet fill:#178600,color:white; classDef cpp fill:#f34b7d,color:white; -classDef erlang fill:#b83998,color:white; classDef golang fill:#00add8,color:black; classDef java fill:#b07219,color:white; classDef javascript fill:#f1e05a,color:black; @@ -80,7 +93,6 @@ graph TD subgraph Service Legend dotnetsvc(.NET):::dotnet cppsvc(C++):::cpp - erlangsvc(Erlang/Elixir):::erlang golangsvc(Go):::golang javasvc(Java):::java javascriptsvc(JavaScript):::javascript @@ -94,7 +106,6 @@ end classDef dotnet fill:#178600,color:white; classDef cpp fill:#f34b7d,color:white; -classDef erlang fill:#b83998,color:white; classDef golang fill:#00add8,color:black; classDef java fill:#b07219,color:white; classDef javascript fill:#f1e05a,color:black; From 861c566e2c5b95e43a14c3e3525611f58614fdd0 Mon Sep 17 00:00:00 2001 From: jack-berg <34418638+jack-berg@users.noreply.github.com> Date: Mon, 25 Nov 2024 04:51:26 -0600 Subject: [PATCH 10/52] Add missing contrib processors, add auto version update for opentelemetry-java-contrib (#5664) --- content/en/docs/languages/java/_index.md | 2 +- content/en/docs/languages/java/sdk.md | 10 ++++++---- scripts/auto-update/all-versions.sh | 1 + 3 files changed, 8 insertions(+), 5 deletions(-) diff --git a/content/en/docs/languages/java/_index.md b/content/en/docs/languages/java/_index.md index 50d2da30240b..a6c31bdd4aa9 100644 --- a/content/en/docs/languages/java/_index.md +++ b/content/en/docs/languages/java/_index.md @@ -8,7 +8,7 @@ cascade: vers: instrumentation: 2.10.0 otel: 1.44.1 - contrib: 1.38.0 + contrib: 1.41.0 semconv: 1.28.0 weight: 18 --- diff --git a/content/en/docs/languages/java/sdk.md b/content/en/docs/languages/java/sdk.md index ef4b13c07a8c..cf7b49074622 100644 --- a/content/en/docs/languages/java/sdk.md +++ b/content/en/docs/languages/java/sdk.md @@ -325,6 +325,7 @@ Span processors built-in to the SDK and maintained by the community in | `BaggageSpanProcessor` | `io.opentelemetry.contrib:opentelemetry-baggage-processor:{{% param vers.contrib %}}-alpha` | Enriches spans with baggage. | | `JfrSpanProcessor` | `io.opentelemetry.contrib:opentelemetry-jfr-events:{{% param vers.contrib %}}-alpha` | Creates JFR events from spans. | | `StackTraceSpanProcessor` | `io.opentelemetry.contrib:opentelemetry-span-stacktrace:{{% param vers.contrib %}}-alpha` | Enriches select spans with stack trace data. | +| `InferredSpansProcessor` | `io.opentelemetry.contrib:opentelemetry-inferred-spans:{{% param vers.contrib %}}-alpha` | Generates spans from async profiler instead of instrumentation. | The following code snippet demonstrates `SpanProcessor` programmatic configuration: @@ -998,10 +999,11 @@ other applications such as data enrichment. Log record processors built-in to the SDK and maintained by the community in `opentelemetry-java-contrib`: -| Class | Artifact | Description | -| -------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------- | -| `BatchLogRecordProcessor` | `io.opentelemetry:opentelemetry-sdk:{{% param vers.otel %}}` | Batches log records and exports them via a configurable `LogRecordExporter`. | -| `SimpleLogRecordProcessor` | `io.opentelemetry:opentelemetry-sdk:{{% param vers.otel %}}` | Exports each log record a via a configurable `LogRecordExporter`. | +| Class | Artifact | Description | +| -------------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | +| `BatchLogRecordProcessor` | `io.opentelemetry:opentelemetry-sdk:{{% param vers.otel %}}` | Batches log records and exports them via a configurable `LogRecordExporter`. | +| `SimpleLogRecordProcessor` | `io.opentelemetry:opentelemetry-sdk:{{% param vers.otel %}}` | Exports each log record a via a configurable `LogRecordExporter`. | +| `EventToSpanEventBridge` | `io.opentelemetry.contrib:opentelemetry-processors:{{% param vers.contrib %}}-alpha` | Records event log records as span events on the current span. | The following code snippet demonstrates `LogRecordProcessor` programmatic configuration: diff --git a/scripts/auto-update/all-versions.sh b/scripts/auto-update/all-versions.sh index d7e990819455..1020bb6a54d4 100755 --- a/scripts/auto-update/all-versions.sh +++ b/scripts/auto-update/all-versions.sh @@ -8,6 +8,7 @@ function auto_update_versions() { "opentelemetry-java otel content/en/docs/zero-code/java/_index.md" "opentelemetry-java-instrumentation instrumentation content/en/docs/languages/java/_index.md" "opentelemetry-java-instrumentation instrumentation content/en/docs/zero-code/java/_index.md" + "opentelemetry-java-contrib contrib content/en/docs/languages/java/_index.md" "opentelemetry-specification spec scripts/content-modules/adjust-pages.pl .gitmodules" "opentelemetry-proto otlp scripts/content-modules/adjust-pages.pl .gitmodules" "semantic-conventions semconv scripts/content-modules/adjust-pages.pl .gitmodules" From f7c0ac79b4419e0742e2778ab0e4e6fcca6dffd1 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Mon, 25 Nov 2024 05:52:03 -0500 Subject: [PATCH 11/52] Make some Collector images dark-mode compatible (#5674) --- .../otel-collector-after-connector.svg | 587 +++++++++++------- .../otel-collector-before-connector.svg | 2 +- .../docs/collector/img/otel-gateway-sdk.svg | 2 +- 3 files changed, 355 insertions(+), 236 deletions(-) diff --git a/content/en/docs/collector/building/connector/otel-collector-after-connector.svg b/content/en/docs/collector/building/connector/otel-collector-after-connector.svg index a6bd7802b339..561951e55d7a 100644 --- a/content/en/docs/collector/building/connector/otel-collector-after-connector.svg +++ b/content/en/docs/collector/building/connector/otel-collector-after-connector.svg @@ -1,235 +1,354 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/content/en/docs/collector/building/connector/otel-collector-before-connector.svg b/content/en/docs/collector/building/connector/otel-collector-before-connector.svg index 662198cd7766..102202599f99 100644 --- a/content/en/docs/collector/building/connector/otel-collector-before-connector.svg +++ b/content/en/docs/collector/building/connector/otel-collector-before-connector.svg @@ -1,6 +1,6 @@ - + diff --git a/content/en/docs/collector/img/otel-gateway-sdk.svg b/content/en/docs/collector/img/otel-gateway-sdk.svg index 006a96a54949..5279ce7a6be3 100644 --- a/content/en/docs/collector/img/otel-gateway-sdk.svg +++ b/content/en/docs/collector/img/otel-gateway-sdk.svg @@ -1,5 +1,5 @@ - + From 1505d056560f20e20d9b956128827bf5642eacd3 Mon Sep 17 00:00:00 2001 From: Severin Neumann Date: Tue, 26 Nov 2024 14:49:08 +0100 Subject: [PATCH 12/52] Update prettier to 3.4.0 (#5684) Signed-off-by: svrnm --- README.md | 8 ++-- .../index.md | 3 +- content/en/blog/2021/gc-election.md | 3 +- content/en/blog/2021/womens-day.md | 3 +- .../blog/2022/debug-otel-with-otel/index.md | 4 +- .../blog/2022/exponential-histograms/index.md | 39 ++++++++++--------- .../instrument-apache-httpd-server/index.md | 13 ++++--- content/en/blog/2022/k8s-metadata/index.md | 9 +++-- content/en/blog/2022/kubecon-na.md | 4 +- .../en/blog/2022/otel-demo-app-nomad/index.md | 4 +- .../blog/2023/contributing-to-otel/index.md | 6 +-- .../blog/2023/ecs-otel-semconv-convergence.md | 11 +++--- .../en/blog/2023/exponential-histograms.md | 20 +++++----- content/en/blog/2023/kubecon-eu.md | 21 +++++----- content/en/blog/2023/kubecon-na.md | 21 +++++----- content/en/blog/2023/logs-collection/index.md | 4 +- .../java-metric-systems-compared/index.md | 11 ++++-- content/en/blog/2024/kubecon-eu.md | 15 +++---- content/en/blog/2024/kubecon-na.md | 16 ++++---- content/en/docs/collector/distributions.md | 6 +-- content/en/docs/collector/installation.md | 12 +++--- .../concepts/instrumentation/libraries.md | 8 ++-- content/en/docs/contributing/_index.md | 6 +-- content/en/docs/contributing/localization.md | 8 ++-- content/en/docs/contributing/pull-requests.md | 6 +-- content/en/docs/demo/forking.md | 4 +- .../docs/languages/erlang/instrumentation.md | 9 +++-- .../en/docs/languages/go/instrumentation.md | 8 ++-- .../en/docs/languages/java/getting-started.md | 14 ++++--- content/en/docs/languages/js/exporters.md | 9 +++-- content/en/docs/languages/js/resources.md | 8 ++-- .../en/docs/languages/net/getting-started.md | 3 +- content/en/docs/languages/net/resources.md | 4 +- .../en/docs/languages/php/getting-started.md | 3 +- .../en/docs/languages/ruby/getting-started.md | 12 +++--- content/en/docs/migration/_index.md | 6 +-- content/en/docs/zero-code/_index.md | 4 +- .../en/docs/zero-code/net/getting-started.md | 12 +++--- content/en/ecosystem/registry/adding.md | 10 ++--- content/es/_index.md | 4 +- content/es/docs/contributing/pull-requests.md | 6 +-- content/es/docs/languages/_index.md | 7 ++-- content/pt/docs/concepts/signals/logs.md | 4 +- content/pt/docs/languages/_index.md | 3 +- .../docs/languages/exporters/intro.md | 4 +- .../docs/languages/exporters/outro.md | 3 +- package.json | 2 +- 47 files changed, 211 insertions(+), 189 deletions(-) diff --git a/README.md b/README.md index 3f4e8247d349..c60044ec0eb3 100644 --- a/README.md +++ b/README.md @@ -44,8 +44,8 @@ We, the OTel Communications SIG, meet every two weeks on Monday at 10:00 PT. Check out the [OpenTelemetry community calendar][] for the Zoom link and any updates to this schedule. -Meeting notes are available as a public [Google doc][]. If you have trouble accessing -the doc, get in touch in the `#otel-comms` channel on [Slack][]. +Meeting notes are available as a public [Google doc][]. If you have trouble +accessing the doc, get in touch in the `#otel-comms` channel on [Slack][]. ## Roles @@ -74,8 +74,8 @@ Here is a list of community roles with current and previous members: - [Morgan McLean](https://github.com/mtwo) - [jparsana](https://github.com/jparsana) -Learn more about roles in the [community repository][]. Thanks to [all who have already -contributed][contributors]! +Learn more about roles in the [community repository][]. Thanks to [all who have +already contributed][contributors]! ## Licenses diff --git a/content/en/blog/2019/opentelemetry-governance-committee-explained/index.md b/content/en/blog/2019/opentelemetry-governance-committee-explained/index.md index 0d57e712b82d..c32b2e24fb2f 100644 --- a/content/en/blog/2019/opentelemetry-governance-committee-explained/index.md +++ b/content/en/blog/2019/opentelemetry-governance-committee-explained/index.md @@ -74,6 +74,7 @@ your questions! Thanks [Sarah Novotny](https://twitter.com/sarahnovotny) for review and feedback! -_A version of this article was [originally posted][] on [medium.com/opentelemetry](https://medium.com/opentelemetry)._ +_A version of this article was [originally posted][] on +[medium.com/opentelemetry](https://medium.com/opentelemetry)._ [originally posted]: {{% param canonical_url %}} diff --git a/content/en/blog/2021/gc-election.md b/content/en/blog/2021/gc-election.md index 3c477b0e8f57..7fad088401b3 100644 --- a/content/en/blog/2021/gc-election.md +++ b/content/en/blog/2021/gc-election.md @@ -6,6 +6,7 @@ canonical_url: https://medium.com/opentelemetry/announcing-the-2021-opentelemetr --- The OpenTelemetry project is excited to announce the 2021 OpenTelemetry -Governance Committee (GC) election. For all the details, see the [original post][]. +Governance Committee (GC) election. For all the details, see the [original +post][]. [original post]: {{% param canonical_url %}} diff --git a/content/en/blog/2021/womens-day.md b/content/en/blog/2021/womens-day.md index b06df675da78..65966a157fbd 100644 --- a/content/en/blog/2021/womens-day.md +++ b/content/en/blog/2021/womens-day.md @@ -6,6 +6,7 @@ canonical_url: https://medium.com/opentelemetry/opentelemetry-observes-internati --- Happy International Women’s Day! The OpenTelemetry project would like to extend -our thanks to all our women contributors. For all the details, see the [original post][]. +our thanks to all our women contributors. For all the details, see the [original +post][]. [original post]: {{% param canonical_url %}} diff --git a/content/en/blog/2022/debug-otel-with-otel/index.md b/content/en/blog/2022/debug-otel-with-otel/index.md index fa89614193d5..4a345339cb98 100644 --- a/content/en/blog/2022/debug-otel-with-otel/index.md +++ b/content/en/blog/2022/debug-otel-with-otel/index.md @@ -229,8 +229,8 @@ in the NGINX module and we need to fix that. ### The fix -To fix our problem we [added some checks to the module for NGINX][], that make sure -that the trace headers are only set once. +To fix our problem we [added some checks to the module for NGINX][], that make +sure that the trace headers are only set once. This fix is contained in the [v1.0.1 release of the otel-webserver-module][]. This means you can update the `Dockerfile` to install the NGINX module like the diff --git a/content/en/blog/2022/exponential-histograms/index.md b/content/en/blog/2022/exponential-histograms/index.md index 4630f7b500c8..e5c666358263 100644 --- a/content/en/blog/2022/exponential-histograms/index.md +++ b/content/en/blog/2022/exponential-histograms/index.md @@ -40,12 +40,13 @@ The SDK is used to configure what happens with the data collected by the API. This typically includes processing it and exporting it out of process for analysis, often to an observability platform. -The API entry point for metrics is the [meter provider][]. It provides meters for -different scopes, where a scope is just a logical unit of application code. For example, -instrumentation for an HTTP client library would have a different scope and therefore -a different meter than instrumentation for a database client library. You use meters -to obtain instruments. You use instruments to report measurements, which consist -of a value and set of attributes. This Java code snippet demonstrates the workflow: +The API entry point for metrics is the [meter provider][]. It provides meters +for different scopes, where a scope is just a logical unit of application code. +For example, instrumentation for an HTTP client library would have a different +scope and therefore a different meter than instrumentation for a database client +library. You use meters to obtain instruments. You use instruments to report +measurements, which consist of a value and set of attributes. This Java code +snippet demonstrates the workflow: ```java OpenTelemetry openTelemetry = // declare OpenTelemetry instance @@ -73,7 +74,8 @@ and when the sum of the things is more important than their individual values the distribution of measurements is relevant for analysis. For example, a histogram is a natural choice for tracking response times for HTTP servers, because it's useful to analyze the distribution of response times to evaluate -SLAs and identify trends. To learn more, see the guidelines for [instrument selection][]. +SLAs and identify trends. To learn more, see the guidelines for [instrument +selection][]. I mentioned earlier that the SDK aggregates measurements from instruments. Each instrument type has a default aggregation strategy (or simply [aggregation][]) @@ -125,10 +127,10 @@ request, you can determine: requests resolve quickly but a small number of requests take a long time and bring down the average. -The second type of OpenTelemetry histogram is the [exponential -bucket histogram][]. Exponential bucket histograms have buckets and bucket -counts, but instead of explicitly defining the bucket boundaries, the boundaries -are computed based on an exponential scale. More specifically, each bucket is +The second type of OpenTelemetry histogram is the [exponential bucket +histogram][]. Exponential bucket histograms have buckets and bucket counts, but +instead of explicitly defining the bucket boundaries, the boundaries are +computed based on an exponential scale. More specifically, each bucket is defined by an index _i_ and has bucket boundaries _(base\*\*i, base\*\*(i+1)]_, where _base\*\*i_ means that _base_ is raised to the power of _i_. The base is derived from a scale factor that is adjustable to reflect the range of reported @@ -197,13 +199,14 @@ large range of measurement values. Let's bring everything together with a proper demonstration comparing explicit bucket histograms to exponential bucket histograms. I've put together some -[example code][] that simulates tracking response time to an HTTP server in milliseconds. -It records one million samples to an explicit bucket histogram with the default buckets, -and to an exponential bucket histogram with a number of buckets that produces roughly -the same size of [OTLP][] -encoded, Gzip-compressed payload as the explicit bucket -defaults. Through trial and error, I determined that ~40 exponential buckets produce -an equivalent payload size to the default explicit bucket histogram with 11 buckets. -(Your results may vary.) +[example code][] that simulates tracking response time to an HTTP server in +milliseconds. It records one million samples to an explicit bucket histogram +with the default buckets, and to an exponential bucket histogram with a number +of buckets that produces roughly the same size of [OTLP][] -encoded, +Gzip-compressed payload as the explicit bucket defaults. Through trial and +error, I determined that ~40 exponential buckets produce an equivalent payload +size to the default explicit bucket histogram with 11 buckets. (Your results may +vary.) I wanted the distribution of samples to reflect what we might see in an actual HTTP server, with bands of response times corresponding to different operations. diff --git a/content/en/blog/2022/instrument-apache-httpd-server/index.md b/content/en/blog/2022/instrument-apache-httpd-server/index.md index b5975f6c7c5d..2dffb1d2b64d 100644 --- a/content/en/blog/2022/instrument-apache-httpd-server/index.md +++ b/content/en/blog/2022/instrument-apache-httpd-server/index.md @@ -8,12 +8,13 @@ cSpell:ignore: Centos centos7 Debajit debuggability libmod uncompress webserver --- If you are using Apache HTTP Server and in dire need of some observability tool -to monitor your web server, the [OpenTelemetry Module for Apache HTTP Server][] is -the right candidate for you: it enables tracing of incoming requests to the server -and it will capture the response time of many modules (including `mod_proxy`) involved -in such an incoming request. With that you will get hierarchical time consumption -by each module. This article demonstrates the monitoring capabilities of the OpenTelemetry -Module for Apache HTTP Server and quick guide to get started with the module. +to monitor your web server, the [OpenTelemetry Module for Apache HTTP Server][] +is the right candidate for you: it enables tracing of incoming requests to the +server and it will capture the response time of many modules (including +`mod_proxy`) involved in such an incoming request. With that you will get +hierarchical time consumption by each module. This article demonstrates the +monitoring capabilities of the OpenTelemetry Module for Apache HTTP Server and +quick guide to get started with the module. ## Getting Started with OpenTelemetry Module diff --git a/content/en/blog/2022/k8s-metadata/index.md b/content/en/blog/2022/k8s-metadata/index.md index 4a343f878c83..013aae54726e 100644 --- a/content/en/blog/2022/k8s-metadata/index.md +++ b/content/en/blog/2022/k8s-metadata/index.md @@ -172,10 +172,11 @@ reducing the scope of the collector service account to a single namespace. ## Using Resource detector processor -As of [recently][pr#832], the [OpenTelemetry operator][] sets the `OTEL_RESOURCE_ATTRIBUTES` -environment variable on the collector container with the K8s pod attributes. This -lets you to use the resource detector processor, which attaches the environment variable -values to the spans. This only works when the collector is deployed in sidecar mode. +As of [recently][pr#832], the [OpenTelemetry operator][] sets the +`OTEL_RESOURCE_ATTRIBUTES` environment variable on the collector container with +the K8s pod attributes. This lets you to use the resource detector processor, +which attaches the environment variable values to the spans. This only works +when the collector is deployed in sidecar mode. For example, if you deploy the following manifest: diff --git a/content/en/blog/2022/kubecon-na.md b/content/en/blog/2022/kubecon-na.md index b46d6417835a..0e36d81a3d2c 100644 --- a/content/en/blog/2022/kubecon-na.md +++ b/content/en/blog/2022/kubecon-na.md @@ -8,8 +8,8 @@ cSpell:ignore: Kowall Logz Pothulapati unconference Vineeth The OpenTelemetry project maintainers, and members of the governance committee and technical committee are excited to be at [KubeCon NA][] in a few weeks! Join -in to meet up in person or virtually for [OpenTelemetry](/) activities in Detroit -from October 24 - 28, 2022. +in to meet up in person or virtually for [OpenTelemetry](/) activities in +Detroit from October 24 - 28, 2022. There are talks, workshops, an unconference as well as a project booth where you are welcome to stop by, say Hi! and tell us about how you are using diff --git a/content/en/blog/2022/otel-demo-app-nomad/index.md b/content/en/blog/2022/otel-demo-app-nomad/index.md index e9b513efb822..7f0ff0eb4cf0 100644 --- a/content/en/blog/2022/otel-demo-app-nomad/index.md +++ b/content/en/blog/2022/otel-demo-app-nomad/index.md @@ -350,8 +350,8 @@ Before I wrap this up, I do want to give a HUGE shoutout to [Luiz Aoqui](https://www.linkedin.com/in/luizaoqui/) of HashiCorp, who helped me tweak my Nomad jobspecs, and to [Riaan Nolan](https://www.linkedin.com/in/riaannolan/), for his continued work -on HashiQube. (Aside, both [Luiz] and [Riaan] were my guests on the [On-Call -Me Maybe Podcast]!) +on HashiQube. (Aside, both [Luiz] and [Riaan] were my guests on the [On-Call Me +Maybe Podcast]!) I will now leave you with a picture of Phoebe the rat, peering out of a pink basket. Doesn’t she look cute? 🥰 diff --git a/content/en/blog/2023/contributing-to-otel/index.md b/content/en/blog/2023/contributing-to-otel/index.md index 3746a3153c30..ac910e12b9f0 100644 --- a/content/en/blog/2023/contributing-to-otel/index.md +++ b/content/en/blog/2023/contributing-to-otel/index.md @@ -25,9 +25,9 @@ projects? I don't know about you, but for me, up until last year, the prospect of contributing to open source was just plain _scary_!! I mean, when you open up a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) -(PR), _[you are putting yourself out there]_, to be judged by those little GitHub -avatars that make up the approvers list for the repository you're contributing to. -YIKES! +(PR), _[you are putting yourself out there]_, to be judged by those little +GitHub avatars that make up the approvers list for the repository you're +contributing to. YIKES! But as scary as the thought of opening a PR might be, it's also SO VERY SATISFYING to see your contributions merged into a codebase. And most diff --git a/content/en/blog/2023/ecs-otel-semconv-convergence.md b/content/en/blog/2023/ecs-otel-semconv-convergence.md index fdb3ec523b12..e76417d4beea 100644 --- a/content/en/blog/2023/ecs-otel-semconv-convergence.md +++ b/content/en/blog/2023/ecs-otel-semconv-convergence.md @@ -47,12 +47,13 @@ and join the discussion on our - [Announcement from Elastic][] - [OpenTelemetry Semantic Conventions][] -- [OTEP 199: Merge Elastic Common Schema with OpenTelemetry Semantic Conventions][] -- [OTEP Issue 197: Proposal: Add support for Elastic Common Schema (ECS) - in OpenTelemetry][] +- [OTEP 199: Merge Elastic Common Schema with OpenTelemetry Semantic + Conventions][] +- [OTEP Issue 197: Proposal: Add support for Elastic Common Schema (ECS) in + OpenTelemetry][] - [OTEP Pull Request 199: Support Elastic Common Schema in OpenTelemetry][] -- [OTEP Pull Request 222: Support Elastic Common Schema (ECS) - in OpenTelemetry][] +- [OTEP Pull Request 222: Support Elastic Common Schema (ECS) in + OpenTelemetry][] [Announcement from Elastic]: https://elastic.co/blog/ecs-elastic-common-schema-otel-opentelemetry-announcement diff --git a/content/en/blog/2023/exponential-histograms.md b/content/en/blog/2023/exponential-histograms.md index 757201196f14..9b481cf8f681 100644 --- a/content/en/blog/2023/exponential-histograms.md +++ b/content/en/blog/2023/exponential-histograms.md @@ -6,13 +6,14 @@ cSpell:ignore: Ganesh Ruslan subsetting Vernekar Vovalov canonical_url: https://dyladan.me/histograms/2023/05/04/exponential-histograms/ --- -Previously, in [Why Histograms?][] and [Histograms vs Summaries][], I went over the -basics of histograms and summaries, explaining the tradeoffs, benefits, and limitations -of each. Because they're easy to understand and demonstrate, those posts focused -on so-called explicit bucket histograms. The exponential bucket histogram, also referred -to as native histogram in Prometheus, is a low-cost, efficient alternative to explicit -bucket histograms. In this post, I go through what they are, how they work, and the -problems they solve that explicit bucket histograms struggle with. +Previously, in [Why Histograms?][] and [Histograms vs Summaries][], I went over +the basics of histograms and summaries, explaining the tradeoffs, benefits, and +limitations of each. Because they're easy to understand and demonstrate, those +posts focused on so-called explicit bucket histograms. The exponential bucket +histogram, also referred to as native histogram in Prometheus, is a low-cost, +efficient alternative to explicit bucket histograms. In this post, I go through +what they are, how they work, and the problems they solve that explicit bucket +histograms struggle with. ## Types of histograms @@ -129,9 +130,8 @@ relative error = (bucketWidth / 2) / bucketMidpoint = 4.329% ``` -For more information regarding histogram errors, see [OTEP 149][] and the [specification -for -exponential histogram aggregations][]. +For more information regarding histogram errors, see [OTEP 149][] and the +[specification for exponential histogram aggregations][]. ## Choosing a scale diff --git a/content/en/blog/2023/kubecon-eu.md b/content/en/blog/2023/kubecon-eu.md index 49f399a8a3eb..5091e3e93549 100644 --- a/content/en/blog/2023/kubecon-eu.md +++ b/content/en/blog/2023/kubecon-eu.md @@ -8,8 +8,8 @@ author: '[Severin Neumann](https://github.com/svrnm)' --- The OpenTelemetry project maintainers, members of the governance committee, and -technical committee are excited to be at [KubeCon EU][] in Amsterdam from April 18 - -21, 2023! +technical committee are excited to be at [KubeCon EU][] in Amsterdam from April +18 - 21, 2023! Read on to learn about all the things related OpenTelemetry during KubeCon. @@ -41,14 +41,15 @@ Come network with OpenTelemetry maintainers and core contributors during the [OpenTelemetry project meeting](https://sched.co/1JWS7), on Tuesday April 18, 2023 from 16:00 - 17:00. You can attend with a _standard in-person pass_. -[Observability Day][] _fosters collaboration, discussion, and knowledge sharing of -cloud-native observability projects_. This event will be held on April 18, 2023 from -9:00 - 17:00. There will be several sessions on OpenTelemetry as well. +[Observability Day][] _fosters collaboration, discussion, and knowledge sharing +of cloud-native observability projects_. This event will be held on April 18, +2023 from 9:00 - 17:00. There will be several sessions on OpenTelemetry as well. > **IMPORTANT access note**: You > need an _in-person all-access_ pass for on-site access to **Observability -> Day**. For details, see [KubeCon registration][]. If you have a virtual ticket, -> you will be able to follow **Observability Day** through a live stream. +> Day**. For details, see [KubeCon registration][]. If you have a virtual +> ticket, you will be able to follow **Observability Day** through a live +> stream. ## OpenTelemetry Project Booth @@ -66,9 +67,9 @@ You will find us in the Solutions Showcase in Hall 5, Kiosk Number 20. You can help us improve the project by sharing your thoughts and feedback about your OpenTelemetry adoption, implementation, and usage! We also invite you to -fill out our [community survey][]. We will create action items from your comments -as appropriate. Check [#otel-user-research][] in CNCF's Slack instance for survey -results and action item updates to come after KubeCon EU. +fill out our [community survey][]. We will create action items from your +comments as appropriate. Check [#otel-user-research][] in CNCF's Slack instance +for survey results and action item updates to come after KubeCon EU. Come join us to listen, learn, and get involved in OpenTelemetry. diff --git a/content/en/blog/2023/kubecon-na.md b/content/en/blog/2023/kubecon-na.md index 6a28a41b229f..643fbd8fc131 100644 --- a/content/en/blog/2023/kubecon-na.md +++ b/content/en/blog/2023/kubecon-na.md @@ -8,8 +8,8 @@ author: '[Severin Neumann](https://github.com/svrnm) (Cisco)' --- The OpenTelemetry project maintainers, members of the governance committee, and -technical committee are thrilled to be at [KubeCon NA][] in Chicago from November -6 - 9, 2023. +technical committee are thrilled to be at [KubeCon NA][] in Chicago from +November 6 - 9, 2023. Read on to learn about all the things related OpenTelemetry during KubeCon. @@ -78,14 +78,15 @@ OpenTelemetry maintainers in making OpenTelemetry better for everyone during the ## Co-located Events -[Observability Day][] _fosters collaboration, discussion, and knowledge sharing of -cloud-native observability projects_. This event will be held on November 6, 2023 -from 9am - 5pm. There will be several sessions on OpenTelemetry as well. +[Observability Day][] _fosters collaboration, discussion, and knowledge sharing +of cloud-native observability projects_. This event will be held on November 6, +2023 from 9am - 5pm. There will be several sessions on OpenTelemetry as well. > **IMPORTANT access note**: You > need an _in-person all-access_ pass for on-site access to **Observability -> Day**. For details, see [KubeCon registration][]. If you have a virtual ticket, -> you will be able to follow **Observability Day** through a live stream. +> Day**. For details, see [KubeCon registration][]. If you have a virtual +> ticket, you will be able to follow **Observability Day** through a live +> stream. ## OpenTelemetry Project Booth @@ -101,9 +102,9 @@ Project Pavilion. If you’re lucky, you may even pick up some OpenTelemetry swa You can help us improve the project by sharing your thoughts and feedback about your OpenTelemetry adoption, implementation, and usage. We also invite you to -fill out our [community survey][]. We will create action items from your comments -as appropriate. Check [#otel-user-research][] in CNCF's Slack instance for survey -results and action item updates to come after KubeCon NA. +fill out our [community survey][]. We will create action items from your +comments as appropriate. Check [#otel-user-research][] in CNCF's Slack instance +for survey results and action item updates to come after KubeCon NA. ## OpenTelemetry Observatory diff --git a/content/en/blog/2023/logs-collection/index.md b/content/en/blog/2023/logs-collection/index.md index 3f3512516462..7408c916fad2 100644 --- a/content/en/blog/2023/logs-collection/index.md +++ b/content/en/blog/2023/logs-collection/index.md @@ -420,8 +420,8 @@ extend Yoda's code to do the following: [transform or attributes processors](/docs/collector/transforming-telemetry/). 1. Add [tracing](/docs/concepts/signals/traces/) support by emitting spans, where it makes sense. -1. Add an Observability backend such as OpenSearch (along with [Data Prepper]) to - the setup, allowing to ingest spans and logs in OTLP format. +1. Add an Observability backend such as OpenSearch (along with [Data Prepper]) + to the setup, allowing to ingest spans and logs in OTLP format. 1. Once you have traces and logs ingested in a backend, try to correlate these two telemetry signal types in the backend along with a frontend such as Grafana. diff --git a/content/en/blog/2024/java-metric-systems-compared/index.md b/content/en/blog/2024/java-metric-systems-compared/index.md index 6085b3c6907e..69a21fa2c920 100644 --- a/content/en/blog/2024/java-metric-systems-compared/index.md +++ b/content/en/blog/2024/java-metric-systems-compared/index.md @@ -13,7 +13,8 @@ across many popular languages, OpenTelemetry reduces the cognitive load of polyglot teams by providing one vocabulary and one toolkit. While that’s all true, today I’d like to zoom in on a specific signal and -language, and talk about the performance of the [OpenTelemetry Java][] metrics SDK. +language, and talk about the performance of the [OpenTelemetry Java][] metrics +SDK. ## Metrics Primer @@ -472,9 +473,11 @@ benefit every application, but are especially important to applications with high cardinality and with strict performance SLAs. If you’re reading this and considering Java metric systems, I hope you chose -[OpenTelemetry Java][]. It’s a powerful and highly performant tool on its own, but -comes with APIs for other key observability signals, a [rich instrumentation ecosystem](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md), -[implementations in a variety of other languages](/docs/languages/), and a well-supported +[OpenTelemetry Java][]. It’s a powerful and highly performant tool on its own, +but comes with APIs for other key observability signals, a +[rich instrumentation ecosystem](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md), +[implementations in a variety of other languages](/docs/languages/), and a +well-supported [open governance structure](https://github.com/open-telemetry/community). ## Acknowledgements diff --git a/content/en/blog/2024/kubecon-eu.md b/content/en/blog/2024/kubecon-eu.md index 0b6e3742e849..1af8ce7a9fca 100644 --- a/content/en/blog/2024/kubecon-eu.md +++ b/content/en/blog/2024/kubecon-eu.md @@ -10,8 +10,9 @@ author: '[Severin Neumann](https://github.com/svrnm) (Cisco)' --- The OpenTelemetry project maintainers, members of the governance committee, and -technical committee are thrilled to be at [KubeCon + CloudNativeCon Europe][] and -at the co-located [Observability Day](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/co-located-events/observability-day/) +technical committee are thrilled to be at [KubeCon + CloudNativeCon Europe][] +and at the co-located +[Observability Day](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/co-located-events/observability-day/) in Paris from March 19 - 22, 2024. Read on to learn about all the things related OpenTelemetry during KubeCon. @@ -45,9 +46,9 @@ it again right before KubeCon! ## Observability Day -_[Observability Day][] fosters collaboration, discussion, and knowledge sharing of -cloud-native observability projects_. This event will be held on March 19, 2024 from -9:00 - 17:35. There will be several sessions on OpenTelemetry as well: +_[Observability Day][] fosters collaboration, discussion, and knowledge sharing +of cloud-native observability projects_. This event will be held on March 19, +2024 from 9:00 - 17:35. There will be several sessions on OpenTelemetry as well: - **[Welcome + Project Updates](https://sched.co/1YGT9)**
by Eduardo Silva, FluentBit & Austin Parker, honeycomb.io
Tuesday, March 19th • 09:00 - @@ -89,8 +90,8 @@ cloud-native observability projects_. This event will be held on March 19, 2024 {{% alert title="Important access note" color="danger" %}} You need an _in-person all-access_ pass for on-site access to **Observability -Day**. For details, see [KubeCon registration][]. If you have a virtual ticket, you -will be able to follow **Observability Day** through a live stream. +Day**. For details, see [KubeCon registration][]. If you have a virtual ticket, +you will be able to follow **Observability Day** through a live stream. [kubecon registration]: https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/register/ diff --git a/content/en/blog/2024/kubecon-na.md b/content/en/blog/2024/kubecon-na.md index 84cb402881ab..f687279e02e6 100644 --- a/content/en/blog/2024/kubecon-na.md +++ b/content/en/blog/2024/kubecon-na.md @@ -8,8 +8,8 @@ author: '[Severin Neumann](https://github.com/svrnm) (Cisco)' --- The OpenTelemetry project maintainers, members of the governance committee, and -technical committee are thrilled to be at [KubeCon NA][] in Salt Lake City from November -12 - 15, 2024. +technical committee are thrilled to be at [KubeCon NA][] in Salt Lake City from +November 12 - 15, 2024. Read on to learn about all the things related OpenTelemetry during KubeCon. @@ -78,15 +78,17 @@ first steps: documentation, Collector, Java, JS, Ruby, Python, .NET, and more. ## Observability Day -_[Observability Day][] fosters collaboration, discussion, and knowledge sharing of -cloud-native observability projects_. This event will be held on November 12, 2024 -from 9am to 6pm. [Check the full schedule](https://colocatedeventsna2024.sched.com/overview/type/Observability+Day) +_[Observability Day][] fosters collaboration, discussion, and knowledge sharing +of cloud-native observability projects_. This event will be held on November 12, +2024 from 9am to 6pm. +[Check the full schedule](https://colocatedeventsna2024.sched.com/overview/type/Observability+Day) to find your favorite talks about Observability and OpenTelemetry. > **IMPORTANT access note**: You > need an _in-person all-access_ pass for on-site access to **Observability -> Day**. For details, see [KubeCon registration][]. If you have a virtual ticket, -> you will be able to follow **Observability Day** through a live stream. +> Day**. For details, see [KubeCon registration][]. If you have a virtual +> ticket, you will be able to follow **Observability Day** through a live +> stream. ## OpenTelemetry Observatory diff --git a/content/en/docs/collector/distributions.md b/content/en/docs/collector/distributions.md index af9e63e425db..9b3c581e6678 100644 --- a/content/en/docs/collector/distributions.md +++ b/content/en/docs/collector/distributions.md @@ -3,9 +3,9 @@ title: Distributions weight: 25 --- -The OpenTelemetry project currently offers [pre-built distributions][] of the collector. -The components included in the [distributions][] can be found by in the `manifest.yaml` -of each distribution. +The OpenTelemetry project currently offers [pre-built distributions][] of the +collector. The components included in the [distributions][] can be found by in +the `manifest.yaml` of each distribution. [pre-built distributions]: https://github.com/open-telemetry/opentelemetry-collector-releases/releases diff --git a/content/en/docs/collector/installation.md b/content/en/docs/collector/installation.md index 9de9bc56d5f6..492531bd2131 100644 --- a/content/en/docs/collector/installation.md +++ b/content/en/docs/collector/installation.md @@ -10,8 +10,8 @@ systems and architectures. The following instructions show how to download and install the latest stable version of the Collector. If you aren't familiar with the deployment models, components, and repositories -applicable to the OpenTelemetry Collector, first review the [Data Collection][] and -[Deployment Methods][] page. +applicable to the OpenTelemetry Collector, first review the [Data Collection][] +and [Deployment Methods][] page. ## Docker @@ -84,10 +84,10 @@ The previous example is meant to serve as a starting point, to be extended and customized before actual production usage. For production-ready customization and installation, see [OpenTelemetry Helm Charts][]. -You can also use the [OpenTelemetry Operator][] to provision and maintain an OpenTelemetry -Collector instance, with features such as automatic upgrade handling, `Service` configuration -based on the OpenTelemetry configuration, automatic sidecar injection into deployments, -and more. +You can also use the [OpenTelemetry Operator][] to provision and maintain an +OpenTelemetry Collector instance, with features such as automatic upgrade +handling, `Service` configuration based on the OpenTelemetry configuration, +automatic sidecar injection into deployments, and more. For guidance on how to use the Collector with Kubernetes, see [Kubernetes Getting Started](/docs/kubernetes/getting-started/). diff --git a/content/en/docs/concepts/instrumentation/libraries.md b/content/en/docs/concepts/instrumentation/libraries.md index 1cbdc24fc33c..38a19054ad73 100644 --- a/content/en/docs/concepts/instrumentation/libraries.md +++ b/content/en/docs/concepts/instrumentation/libraries.md @@ -5,8 +5,8 @@ aliases: [../instrumenting-library] weight: 40 --- -OpenTelemetry provides [instrumentation libraries][] for many libraries, which is -typically done through library hooks or monkey-patching library code. +OpenTelemetry provides [instrumentation libraries][] for many libraries, which +is typically done through library hooks or monkey-patching library code. Native library instrumentation with OpenTelemetry provides better observability and developer experience for users, removing the need for libraries to expose @@ -245,8 +245,8 @@ already have OpenTelemetry integration. To find out, see the context on all logs, so users can correlate them. If your language and ecosystem don't have common logging support, use [span -events][] to share additional app details. Events maybe more convenient if you want -to add attributes as well. +events][] to share additional app details. Events maybe more convenient if you +want to add attributes as well. As a rule of thumb, use events or logs for verbose data instead of spans. Always attach events to the span instance that your instrumentation created. Avoid diff --git a/content/en/docs/contributing/_index.md b/content/en/docs/contributing/_index.md index 4fc089ff9475..d54fc9332104 100644 --- a/content/en/docs/contributing/_index.md +++ b/content/en/docs/contributing/_index.md @@ -43,9 +43,9 @@ The pages in this section describe how to contribute to OpenTelemetry **documentation**. For guidance on how to contribute to the OpenTelemetry project in general, see -the community [OpenTelemetry New Contributor Guide]. Every [OTel repository][org] -for language implementations, the Collector, and conventions have their own project-specific -contributing guides. +the community [OpenTelemetry New Contributor Guide]. Every [OTel +repository][org] for language implementations, the Collector, and conventions +have their own project-specific contributing guides. [OpenTelemetry New Contributor Guide]: https://github.com/open-telemetry/community/blob/main/guides/contributor diff --git a/content/en/docs/contributing/localization.md b/content/en/docs/contributing/localization.md index 615669b7ef09..86370e8f4fe9 100644 --- a/content/en/docs/contributing/localization.md +++ b/content/en/docs/contributing/localization.md @@ -6,10 +6,10 @@ weight: 25 cSpell:ignore: shortcodes --- -The OTel website uses Hugo's [multilingual framework] to support page localizations. -English is the default language, with US English as the default (implicit) localization. -A growing number of other localizations are supported, as can be seen from the languages -dropdown menu in the top nav. +The OTel website uses Hugo's [multilingual framework] to support page +localizations. English is the default language, with US English as the default +(implicit) localization. A growing number of other localizations are supported, +as can be seen from the languages dropdown menu in the top nav. ## English language maintainer guidance diff --git a/content/en/docs/contributing/pull-requests.md b/content/en/docs/contributing/pull-requests.md index ac831674f9c7..8f64afb815d4 100644 --- a/content/en/docs/contributing/pull-requests.md +++ b/content/en/docs/contributing/pull-requests.md @@ -384,9 +384,9 @@ close the terminal window. ### Site deploys and PR previews -If you submit a PR, Netlify creates a [deploy preview][] so that you can review your -changes. Once your PR is merged, Netlify deploys the updated site to the production -server. +If you submit a PR, Netlify creates a [deploy preview][] so that you can review +your changes. Once your PR is merged, Netlify deploys the updated site to the +production server. > **Note**: PR previews include _draft pages_, but production builds do not. diff --git a/content/en/docs/demo/forking.md b/content/en/docs/demo/forking.md index 6aa882a3f337..e3f4930d5078 100644 --- a/content/en/docs/demo/forking.md +++ b/content/en/docs/demo/forking.md @@ -3,8 +3,8 @@ title: Forking the demo repository linkTitle: Forking --- -The [demo repository][] is designed to be forked and used as a tool to show off what -you are doing with OpenTelemetry. +The [demo repository][] is designed to be forked and used as a tool to show off +what you are doing with OpenTelemetry. Setting up a fork or a demo usually only requires overriding some environment variables and possibly replacing some container images. diff --git a/content/en/docs/languages/erlang/instrumentation.md b/content/en/docs/languages/erlang/instrumentation.md index 8d815f5daaef..7f0c714c0ada 100644 --- a/content/en/docs/languages/erlang/instrumentation.md +++ b/content/en/docs/languages/erlang/instrumentation.md @@ -267,10 +267,11 @@ end ### Semantic Attributes Semantic Attributes are attributes that are defined by the [OpenTelemetry -Specification][] in order to provide a shared set of attribute keys across multiple -languages, frameworks, and runtimes for common concepts like HTTP methods, status -codes, user agents, and more. These attribute keys are generated from the specification -and provided in [opentelemetry_semantic_conventions](https://hex.pm/packages/opentelemetry_semantic_conventions). +Specification][] in order to provide a shared set of attribute keys across +multiple languages, frameworks, and runtimes for common concepts like HTTP +methods, status codes, user agents, and more. These attribute keys are generated +from the specification and provided in +[opentelemetry_semantic_conventions](https://hex.pm/packages/opentelemetry_semantic_conventions). For example, an instrumentation for an HTTP client or server would need to include semantic attributes like the scheme of the URL: diff --git a/content/en/docs/languages/go/instrumentation.md b/content/en/docs/languages/go/instrumentation.md index ef60971ac96a..46688b93d17f 100644 --- a/content/en/docs/languages/go/instrumentation.md +++ b/content/en/docs/languages/go/instrumentation.md @@ -185,10 +185,10 @@ span.SetAttributes(myKey.String("a value")) #### Semantic Attributes Semantic Attributes are attributes that are defined by the [OpenTelemetry -Specification][] in order to provide a shared set of attribute keys across multiple -languages, frameworks, and runtimes for common concepts like HTTP methods, status -codes, user agents, and more. These attributes are available in the `go.opentelemetry.io/otel/semconv/v1.26.0` -package. +Specification][] in order to provide a shared set of attribute keys across +multiple languages, frameworks, and runtimes for common concepts like HTTP +methods, status codes, user agents, and more. These attributes are available in +the `go.opentelemetry.io/otel/semconv/v1.26.0` package. For details, see [Trace semantic conventions][]. diff --git a/content/en/docs/languages/java/getting-started.md b/content/en/docs/languages/java/getting-started.md index 69fd4a79dedd..8e56332f3866 100644 --- a/content/en/docs/languages/java/getting-started.md +++ b/content/en/docs/languages/java/getting-started.md @@ -22,9 +22,10 @@ Ensure that you have the following installed locally: ## Example Application -The following example uses a basic [Spring Boot] application. You can use another -web framework, such as Apache Wicket or Play. For a complete list of libraries and -supported frameworks, consult the [registry](/ecosystem/registry/?component=instrumentation&language=java). +The following example uses a basic [Spring Boot] application. You can use +another web framework, such as Apache Wicket or Play. For a complete list of +libraries and supported frameworks, consult the +[registry](/ecosystem/registry/?component=instrumentation&language=java). For more elaborate examples, see [examples](../examples/). @@ -145,8 +146,8 @@ agent][] in a number of ways, the steps below use environment variables. to the JAR file.{{% /alert %}} 2. Set and export variables that specify the Java agent JAR and a [console - exporter][], using a notation suitable for your shell/terminal environment — - we illustrate a notation for bash-like shells: + exporter][], using a notation suitable for your shell/terminal environment + — we illustrate a notation for bash-like shells: ```sh export JAVA_TOOL_OPTIONS="-javaagent:PATH/TO/opentelemetry-javaagent.jar" \ @@ -248,7 +249,8 @@ For more: - Try [zero-code instrumentation](/docs/zero-code/java/agent/) on one of your own apps. - For light-weight customized telemetry, try [annotations][]. -- Learn about [manual instrumentation][] and try out more [examples](../examples/). +- Learn about [manual instrumentation][] and try out more + [examples](../examples/). - Take a look at the [OpenTelemetry Demo](/docs/demo/), which includes Java based [Ad Service](/docs/demo/services/ad/) and Kotlin based [Fraud Detection Service](/docs/demo/services/fraud-detection/) diff --git a/content/en/docs/languages/js/exporters.md b/content/en/docs/languages/js/exporters.md index 3b00b9ad964c..401ed6884541 100644 --- a/content/en/docs/languages/js/exporters.md +++ b/content/en/docs/languages/js/exporters.md @@ -134,8 +134,8 @@ collector. #### Use OTLP exporter with HTTP/JSON or HTTP/protobuf [OpenTelemetry Collector Exporter with gRPC][] works only with Node.js, -therefore you are limited to use the [OpenTelemetry Collector Exporter -with HTTP/JSON][] or [OpenTelemetry Collector Exporter with HTTP/protobuf][]. +therefore you are limited to use the [OpenTelemetry Collector Exporter with +HTTP/JSON][] or [OpenTelemetry Collector Exporter with HTTP/protobuf][]. Make sure that the receiving end of your exporter (collector or observability backend) accepts `http/json` if you are using [OpenTelemetry Collector Exporter @@ -161,8 +161,9 @@ If your website and collector are hosted at a different origin, your browser might block the requests going out to your collector. You need to configure special headers for Cross-Origin Resource Sharing (CORS). -The OpenTelemetry Collector provides [a feature][] for http-based receivers to add -the required headers to allow the receiver to accept traces from a web browser: +The OpenTelemetry Collector provides [a feature][] for http-based receivers to +add the required headers to allow the receiver to accept traces from a web +browser: ```yaml receivers: diff --git a/content/en/docs/languages/js/resources.md b/content/en/docs/languages/js/resources.md index f0dc34e02c6e..7972a35f5a75 100644 --- a/content/en/docs/languages/js/resources.md +++ b/content/en/docs/languages/js/resources.md @@ -12,13 +12,13 @@ Node.js SDK. ## Setup -Follow the instructions in the [Getting Started - Node.js][], so that you have the -files `package.json`, `app.js` and `tracing.js`. +Follow the instructions in the [Getting Started - Node.js][], so that you have +the files `package.json`, `app.js` and `tracing.js`. ## Process & Environment Resource Detection -Out of the box, the Node.js SDK detects [process and process -runtime resources][] and takes attributes from the environment variable +Out of the box, the Node.js SDK detects [process and process runtime +resources][] and takes attributes from the environment variable `OTEL_RESOURCE_ATTRIBUTES`. You can verify what it detects by turning on diagnostic logging in `tracing.js`: diff --git a/content/en/docs/languages/net/getting-started.md b/content/en/docs/languages/net/getting-started.md index 29301d2e10f3..f7fd44784209 100644 --- a/content/en/docs/languages/net/getting-started.md +++ b/content/en/docs/languages/net/getting-started.md @@ -265,7 +265,8 @@ For more: - Run this example with another [exporter][] for telemetry data. - Try [automatic instrumentation](/docs/zero-code/net/) on one of your own apps. -- Learn about [manual instrumentation][] and try out more [examples](/docs/languages/net/examples/). +- Learn about [manual instrumentation][] and try out more + [examples](/docs/languages/net/examples/). - Take a look at the [OpenTelemetry Demo](/docs/demo/), which includes .NET based [Cart Service](/docs/demo/services/cart/). diff --git a/content/en/docs/languages/net/resources.md b/content/en/docs/languages/net/resources.md index 42b4eea6e9e6..4d51bbddff83 100644 --- a/content/en/docs/languages/net/resources.md +++ b/content/en/docs/languages/net/resources.md @@ -8,8 +8,8 @@ cSpell:ignore: myhost pcarter uuidgen ## Setup -Follow the instructions in the [Getting Started][], so that you have a running .NET -app exporting data to the console. +Follow the instructions in the [Getting Started][], so that you have a running +.NET app exporting data to the console. ## Adding resources with environment variables diff --git a/content/en/docs/languages/php/getting-started.md b/content/en/docs/languages/php/getting-started.md index 5e8674a1827f..59ba88e61d40 100644 --- a/content/en/docs/languages/php/getting-started.md +++ b/content/en/docs/languages/php/getting-started.md @@ -489,7 +489,8 @@ For more: - Run this example with another [exporter][] for telemetry data. - Try [zero-code instrumentation](/docs/zero-code/php/) on one of your own apps. -- Learn more about [manual instrumentation][] and try out some [examples](/docs/languages/php/examples/). +- Learn more about [manual instrumentation][] and try out some + [examples](/docs/languages/php/examples/). - Take a look at the [OpenTelemetry Demo](/docs/demo/), which includes the PHP based [Quote Service](/docs/demo/services/quote/). diff --git a/content/en/docs/languages/ruby/getting-started.md b/content/en/docs/languages/ruby/getting-started.md index 45458b1db6fb..3adda09029db 100644 --- a/content/en/docs/languages/ruby/getting-started.md +++ b/content/en/docs/languages/ruby/getting-started.md @@ -177,12 +177,12 @@ Adding tracing to a single service is a great first step. OpenTelemetry provides a few more features that will allow you gain even deeper insights! - [Exporters][] allow you to export your data to a preferred backend. -- [Context propagation][] is perhaps one of the most powerful concepts in OpenTelemetry - because it will upgrade your single service trace into a _distributed trace_, which - makes it possible for OpenTelemetry vendors to visualize a request from end-to-end - across process and network boundaries. -- [Span events][] allow you to add a human-readable message on a span that represents - "something happening" during its lifetime. +- [Context propagation][] is perhaps one of the most powerful concepts in + OpenTelemetry because it will upgrade your single service trace into a + _distributed trace_, which makes it possible for OpenTelemetry vendors to + visualize a request from end-to-end across process and network boundaries. +- [Span events][] allow you to add a human-readable message on a span that + represents "something happening" during its lifetime. - [Instrumentation][instrumentation] will give provide you the ability to enrich your traces with domain specific data. - [The OpenTelemetry Demo](/docs/demo/) includes the Ruby based diff --git a/content/en/docs/migration/_index.md b/content/en/docs/migration/_index.md index 3b0ea9ef9938..650cbb345c93 100644 --- a/content/en/docs/migration/_index.md +++ b/content/en/docs/migration/_index.md @@ -7,9 +7,9 @@ weight: 950 ## OpenTracing and OpenCensus OpenTelemetry was created as a merger of OpenTracing and OpenCensus. From the -start, OpenTelemetry was considered [to be the next major version of -both OpenTracing and OpenCensus][]. Because of that, one of the [key goals][] of -the OpenTelemetry project is to provide backward compatibility with both projects +start, OpenTelemetry was considered [to be the next major version of both +OpenTracing and OpenCensus][]. Because of that, one of the [key goals][] of the +OpenTelemetry project is to provide backward compatibility with both projects and a migration story for existing users. If you come from one of these projects, you can follow the migration guides for diff --git a/content/en/docs/zero-code/_index.md b/content/en/docs/zero-code/_index.md index 64daee7bce94..b7859e14fd5c 100644 --- a/content/en/docs/zero-code/_index.md +++ b/content/en/docs/zero-code/_index.md @@ -3,8 +3,8 @@ title: Zero-code Instrumentation weight: 260 --- -OpenTelemetry [zero-code instrumentation][] is supported for the languages listed -below in the section index. +OpenTelemetry [zero-code instrumentation][] is supported for the languages +listed below in the section index. If you are using Kubernetes, you can use the [OpenTelemetry Operator for Kubernetes][otel-op] to [inject zero-code instrumentation] for .NET, Java, diff --git a/content/en/docs/zero-code/net/getting-started.md b/content/en/docs/zero-code/net/getting-started.md index de51a67166e5..8233aec86f4c 100644 --- a/content/en/docs/zero-code/net/getting-started.md +++ b/content/en/docs/zero-code/net/getting-started.md @@ -107,8 +107,8 @@ dotnet run ## Instrumentation Next, you'll use a [OpenTelemetry .NET Automatic Instrumentation](../) to -instrument the application at launch time. While you can [configure -.NET Automatic Instrumentation][] in a number of ways, the steps below use Unix-shell +instrument the application at launch time. While you can [configure .NET +Automatic Instrumentation][] in a number of ways, the steps below use Unix-shell or PowerShell scripts. > **Note**: PowerShell commands require elevated (administrator) privileges. @@ -150,10 +150,10 @@ or PowerShell scripts. {{% /tab %}} {{< /tabpane >}} -3. Set and export variables that specify a [console exporter][], then execute script - configuring other necessary environment variables using a notation suitable for - your shell/terminal environment — we illustrate a notation for bash-like - shells and PowerShell: +3. Set and export variables that specify a [console exporter][], then execute + script configuring other necessary environment variables using a notation + suitable for your shell/terminal environment — we illustrate a notation + for bash-like shells and PowerShell: {{< tabpane text=true >}} {{% tab Unix-shell %}} diff --git a/content/en/ecosystem/registry/adding.md b/content/en/ecosystem/registry/adding.md index a8ba254acf73..c5631e6c4332 100644 --- a/content/en/ecosystem/registry/adding.md +++ b/content/en/ecosystem/registry/adding.md @@ -7,13 +7,13 @@ description: How to add entries to the registry. Do you maintain or contribute to an integration for OpenTelemetry? We'd love to feature your project in the [registry](../)! -To add your project, submit a [pull request][]. You'll need to create a data file -in [data/registry][] for your project, by using the following template: [registry-entry.yml][]. +To add your project, submit a [pull request][]. You'll need to create a data +file in [data/registry][] for your project, by using the following template: +[registry-entry.yml][]. Make sure that your project names and descriptions follow our [marketing -guidelines][] and are in line with the Linux Foundation’s branding and [trademark -usage -guidelines][]. +guidelines][] and are in line with the Linux Foundation’s branding and +[trademark usage guidelines][]. [data/registry]: https://github.com/open-telemetry/opentelemetry.io/tree/main/data/registry diff --git a/content/es/_index.md b/content/es/_index.md index 055348df93ce..85c3e0cb2a63 100644 --- a/content/es/_index.md +++ b/content/es/_index.md @@ -85,8 +85,8 @@ líneas de código. {{% blocks/section color="secondary" type="cncf" %}} -**OpenTelemetry es un proyecto [CNCF][] [en incubación][]**.
Se formó a partir -de la fusión de los proyectos OpenTracing y OpenCensus. +**OpenTelemetry es un proyecto [CNCF][] [en incubación][]**.
Se formó a +partir de la fusión de los proyectos OpenTracing y OpenCensus. [![CNCF logo][]][cncf] diff --git a/content/es/docs/contributing/pull-requests.md b/content/es/docs/contributing/pull-requests.md index 624db9e6e20a..bb45f93e7e8d 100644 --- a/content/es/docs/contributing/pull-requests.md +++ b/content/es/docs/contributing/pull-requests.md @@ -388,9 +388,9 @@ Para detener la instancia local de Hugo, vuelve a la terminal y escriba ### Implementaciones del sitio y vistas previas de PR -Si envías una PR, Netlify crea una [Vista Previa de Implementación][] para que puedas -revisar sus cambios. Una vez que se fusiona su PR, Netlify implementa el sitio actualizado -en el servidor de producción. +Si envías una PR, Netlify crea una [Vista Previa de Implementación][] para que +puedas revisar sus cambios. Una vez que se fusiona su PR, Netlify implementa el +sitio actualizado en el servidor de producción. > **Nota**: Las vistas previas de PR incluyen _páginas de borrador_, pero las > compilaciones de producción no. diff --git a/content/es/docs/languages/_index.md b/content/es/docs/languages/_index.md index aca40497b103..7a361239f385 100644 --- a/content/es/docs/languages/_index.md +++ b/content/es/docs/languages/_index.md @@ -29,10 +29,9 @@ el siguiente: {{% alert title="Importante" color="warning" %}} Independientemente del estado de un API/SDK, si tu instrumentación depende de -[convenciones semánticas] que estén marcadas como [Experimental] en la [especificación -de -convenciones semánticas], tu flujo de datos podría estar sujeto a **cambios -importantes**. +[convenciones semánticas] que estén marcadas como [Experimental] en la +[especificación de convenciones semánticas], tu flujo de datos podría estar +sujeto a **cambios importantes**. [convenciones semánticas]: /docs/concepts/semantic-conventions/ [Experimental]: /docs/specs/otel/document-status/ diff --git a/content/pt/docs/concepts/signals/logs.md b/content/pt/docs/concepts/signals/logs.md index 04c928aada25..ada95cef2f3c 100644 --- a/content/pt/docs/concepts/signals/logs.md +++ b/content/pt/docs/concepts/signals/logs.md @@ -246,7 +246,7 @@ Para mais detalhes sobre registros de log e campos de log, consulte ### Especificação {#specification} -Para saber mais sobre logs no OpenTelemetry, consulte a [especificação -de logs][]. +Para saber mais sobre logs no OpenTelemetry, consulte a [especificação de +logs][]. [especificação de logs]: /docs/specs/otel/overview/#log-signal diff --git a/content/pt/docs/languages/_index.md b/content/pt/docs/languages/_index.md index 28b15aef2c58..2ff6a33cf783 100644 --- a/content/pt/docs/languages/_index.md +++ b/content/pt/docs/languages/_index.md @@ -30,8 +30,7 @@ seguir: Independente do estado de um API/SDK, se a sua instrumentação depende de [convenções semânticas] que são marcadas como [Experimental] na [especificação -de -convenções semânticas], seu fluxo de dados pode estar sujeito à **quebra de +de convenções semânticas], seu fluxo de dados pode estar sujeito à **quebra de compatibilidade** [convenções semânticas]: /docs/concepts/semantic-conventions/ diff --git a/layouts/shortcodes/docs/languages/exporters/intro.md b/layouts/shortcodes/docs/languages/exporters/intro.md index cc96afdd2006..43cb2a6a7b6f 100644 --- a/layouts/shortcodes/docs/languages/exporters/intro.md +++ b/layouts/shortcodes/docs/languages/exporters/intro.md @@ -51,8 +51,8 @@ them up. diff --git a/layouts/shortcodes/docs/languages/exporters/outro.md b/layouts/shortcodes/docs/languages/exporters/outro.md index 8f4add50c32c..a6ccb6adc578 100644 --- a/layouts/shortcodes/docs/languages/exporters/outro.md +++ b/layouts/shortcodes/docs/languages/exporters/outro.md @@ -3,7 +3,8 @@ ## Custom exporters Finally, you can also write your own exporter. For more information, see the -[SpanExporter Interface in the API documentation]({{ $spanExporterInterfaceUrl }}). +[SpanExporter Interface in the API +documentation]({{ $spanExporterInterfaceUrl }}). ## Batching span and log records diff --git a/package.json b/package.json index c2f74763de4c..8d4f437dfedc 100644 --- a/package.json +++ b/package.json @@ -123,7 +123,7 @@ "markdown-link-check": "^3.13.6", "markdownlint": "^0.36.1", "postcss-cli": "^11.0.0", - "prettier": "^3.3.3", + "prettier": "^3.4.0", "require-dir": "^1.2.0", "textlint": "^14.3.0", "textlint-filter-rule-allowlist": "^4.0.0", From 5fb790001fa841343d7e7df73d98b621910329e6 Mon Sep 17 00:00:00 2001 From: Yuvraj Achrekar Date: Wed, 27 Nov 2024 02:48:16 +0530 Subject: [PATCH 13/52] Update adopters.yaml for Adoptors page (#5662) Co-authored-by: Phillip Carter --- data/ecosystem/adopters.yaml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/data/ecosystem/adopters.yaml b/data/ecosystem/adopters.yaml index f8d243799426..74a587515358 100644 --- a/data/ecosystem/adopters.yaml +++ b/data/ecosystem/adopters.yaml @@ -8,6 +8,7 @@ url: https://bureau.id/ components: [Collector, Python, Go, Lambda] reference: 'https://tech.bureau.id/connecting-the-dots-with-opentelemetry-part-ii-5ea5f6b06c29' + referenceTitle: blog post contact: https://github.com/ethicalmohit - name: Care.com url: https://www.care.com @@ -28,6 +29,7 @@ url: https://dyte.io components: [Go, Javascript] reference: 'https://dyte.io/blog/opentelemetry-at-dyte-part-i/' + referenceTitle: blog post contact: https://github.com/ethicalmohit - name: eBay url: https://www.ebay.com @@ -127,6 +129,7 @@ url: https://www.vtex.com/ components: [Collector, Go, JavaScript, .NET] reference: 'https://colocatedeventseu2023.sched.com/event/1Jo8E/ingesting-65-tb-of-telemetry-data-daily-through-open-telemetry-protocol-and-collectors-gustavo-pantuza-vtex' + referenceTitle: presentation contact: 'sre-observability@vtex.com' - name: Wandera url: https://www.wandera.com/ From 6b6a3b2d6f689c9e18b678d489c6860d28b29ec3 Mon Sep 17 00:00:00 2001 From: Tyler Helmuth <12352919+TylerHelmuth@users.noreply.github.com> Date: Tue, 26 Nov 2024 14:18:42 -0700 Subject: [PATCH 14/52] fix: Update filelog receiver operators in kubernetes docs (#5697) --- .../docs/kubernetes/collector/components.md | 72 ++----------------- 1 file changed, 4 insertions(+), 68 deletions(-) diff --git a/content/en/docs/kubernetes/collector/components.md b/content/en/docs/kubernetes/collector/components.md index 51bd7749bd68..59384c698ffd 100644 --- a/content/en/docs/kubernetes/collector/components.md +++ b/content/en/docs/kubernetes/collector/components.md @@ -283,77 +283,13 @@ filelog: exclude: # Exclude logs from all containers named otel-collector - /var/log/pods/*/otel-collector/*.log - start_at: beginning + start_at: end include_file_path: true include_file_name: false operators: - # Find out which format is used by kubernetes - - type: router - id: get-format - routes: - - output: parser-docker - expr: 'body matches "^\\{"' - - output: parser-crio - expr: 'body matches "^[^ Z]+ "' - - output: parser-containerd - expr: 'body matches "^[^ Z]+Z"' - # Parse CRI-O format - - type: regex_parser - id: parser-crio - regex: - '^(?P