Skip to content

Commit 00f66f8

Browse files
authored
Merge branch 'main' into opentelemetrybot/auto-update-registry-f37001338afdbd51f1e096c1dd66447dabc359e4
2 parents a1e1322 + e9b4922 commit 00f66f8

File tree

24 files changed

+650
-67
lines changed

24 files changed

+650
-67
lines changed

.cspell.yml

+2
Original file line numberDiff line numberDiff line change
@@ -58,3 +58,5 @@ dictionaries:
5858
words: # Valid words across all locales
5959
- Docsy
6060
- htmltest
61+
# Hugo
62+
- warnf

.cspell/es-palabras.txt

+2
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,5 @@ Muestreadores
1414
muestreadores
1515
monitoreo
1616
multilenguaje
17+
redireccionar
18+
prerrellenada

content/en/blog/2023/http-conventions-declared-stable.md

+6-14
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,11 @@ title: HTTP semantic conventions declared stable
33
linkTitle: HTTP semconv are stable
44
date: 2023-11-06
55
author: '[Trask Stalnaker](https://github.com/trask) (Microsoft)'
6-
cSpell:ignore: chalin Liudmila Molkova
6+
cSpell:ignore: Liudmila Molkova
77
---
88

9+
<!-- markdownlint-disable table-pipe-style table-column-count -->
10+
911
Early this year, we launched an effort to stabilize HTTP semantic conventions.
1012
Today, we proudly announce that the HTTP semantic conventions are the _first_
1113
OpenTelemetry semantic conventions to be declared
@@ -95,8 +97,6 @@ to
9597
| `net.sock.peer.name` | Removed |
9698
| New: `http.request.method_original` | Only captured when `http.request.method` is `_OTHER` |
9799
| New: `error.type` | New |
98-
99-
{.td-initial .table .table-responsive}
100100
<!-- prettier-ignore-end -->
101101

102102
References:
@@ -106,10 +106,8 @@ References:
106106

107107
### HTTP client span attributes
108108

109-
<!-- TODO(@chalin): I'll move this embedded style elsewhere in a followup PR -->
110109
<style>
111-
.ot-table-first-row-50 td:first-child { width: 50%; }
112-
.ot-table-first-row-60 td:first-child { width: 60%; }
110+
.ot-table-first-col-50 th:first-child { width: 50%; }
113111
</style>
114112

115113
<!-- prettier-ignore-start -->
@@ -119,8 +117,6 @@ References:
119117
| `http.resend_count` &rarr; `http.request.resend_count` | |
120118
| `net.peer.name` &rarr; `server.address` | |
121119
| `net.peer.port` &rarr; `server.port` | Now captured even when same as default port for scheme |
122-
123-
{.td-initial .table .table-responsive .ot-table-first-row-60}
124120
<!-- prettier-ignore-end -->
125121

126122
References:
@@ -139,8 +135,7 @@ References:
139135
| `http.client_ip` &rarr; `client.address` | If `http.client_ip` was unknown (i.e., no [X-Forwarded-For][], [Forwarded#for][] headers), then `net.sock.peer.addr` &rarr; `client.address`; now must be provided to sampler |
140136
| `net.host.name` &rarr; `server.address` | Now based only on [Host][Host header], [:authority][HTTP/2 authority], [X-Forwarded-Host][], [Forwarded#host][] headers |
141137
| `net.host.port` &rarr; `server.port` | Now based only on [Host][Host header], [:authority][HTTP/2 authority], [X-Forwarded-Host][X-Forwarded-Host], [Forwarded#host][] headers |
142-
143-
{.td-initial .table .table-responsive .ot-table-first-row-50}
138+
{.ot-table-first-col-50}
144139
<!-- prettier-ignore-end -->
145140

146141
References:
@@ -183,8 +178,6 @@ Metric changes:
183178
| `net.protocol.name` &rarr; `network.protocol.name` | Recommended &rarr; Conditionally required if not `http` and `network.protocol.version` is set |
184179
| `net.protocol.version` &rarr; `network.protocol.version` | Examples fixed: `2.0` &rarr; `2` and `3.0` &rarr; `3`; see note if [migrating from `<= v1.19.0`](#migrating-from--v1190) |
185180
| New: `error.type` | New |
186-
187-
{.td-initial .table .table-responsive}
188181
<!-- prettier-ignore-end -->
189182

190183
References:
@@ -216,8 +209,7 @@ Metric changes:
216209
| `net.host.name``server.address` | &bullet; Recommended → Opt-In (due to high-cardinality vulnerability since based on HTTP headers)<br>&bullet; Now based only on [`Host` span][Host header], [`:authority` span][HTTP/2 authority], [`X-Forwarded-Host` span][X-Forwarded-Host], [`Forwarded#host` span][Forwarded#host] headers |
217210
| `net.host.port``server.port` | &bullet; Recommended → Opt-In (due to high-cardinality vulnerability since based on HTTP headers)<br>&bullet; Now based only on [`Host` span][Host header], [`:authority` span][HTTP/2 authority], [`X-Forwarded-Host` span][X-Forwarded-Host], [`Forwarded#host` span][Forwarded#host] headers |
218211
| New: `error.type` | New |
219-
220-
{.td-initial .table .table-responsive .ot-table-first-row-50}
212+
{.ot-table-first-col-50}
221213
<!-- prettier-ignore-end -->
222214

223215
References:
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: # Bogus entry for markdownlint
3+
_build: { list: never, render: never }
4+
---
5+
6+
{{% alert-md title=Warning color=warning %}}
7+
8+
Client instrumentation for the browser is **experimental** and mostly
9+
**unspecified**. If you are interested in helping out, get in touch with the
10+
[Client Instrumentation SIG][sig].
11+
12+
[sig]:
13+
https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w
14+
15+
{{% /alert-md %}}

content/en/docs/languages/js/_index.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,7 @@ weight: 20
1010

1111
{{% docs/languages/index-intro js /%}}
1212

13-
{{% alert title="Warning" color="warning" %}}
14-
{{% param notes.browser-instrumentation %}} {{% /alert %}}
13+
{{% include browser-instrumentation-warning.md %}}
1514

1615
## Version Support
1716

content/en/docs/languages/js/getting-started/browser.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@ description: Learn how to add OpenTelemetry to your browser app
55
weight: 20
66
---
77

8-
{{% alert title="Warning" color="warning" %}}
9-
{{% param notes.browser-instrumentation %}} {{% /alert %}}
8+
{{% include browser-instrumentation-warning.md %}}
109

1110
While this guide uses the example application presented below, the steps to
1211
instrument your own application should be similar.

content/en/docs/languages/js/instrumentation.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -335,8 +335,7 @@ above, you have a `TracerProvider` setup for you already. You can continue with
335335

336336
#### Browser
337337

338-
{{% alert title="Warning" color="warning" %}}
339-
{{% param notes.browser-instrumentation %}} {{% /alert %}}
338+
{{% include browser-instrumentation-warning.md %}}
340339

341340
First, ensure you've got the right packages:
342341

+106
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
---
2+
title: Propuestas
3+
description:
4+
Cómo solucionar un problema existente o informar un error, un riesgo de
5+
seguridad o una posible mejora.
6+
weight: 10
7+
_issues: https://github.com/open-telemetry/opentelemetry.io/issues
8+
_issue: https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A
9+
default_lang_commit: 99f0ae5760038d51f9e9eb376bb428a2caca8167
10+
---
11+
12+
## Solucionando una propuesta existente
13+
14+
Una de las mejores maneras de contribuir a mejorar la documentación de
15+
OpenTelemetry (OTel) es solucionando un problema ya identificado.
16+
17+
1. Navegar por la lista de [propuestas]({{% param _issues %}}).
18+
2. Seleccione una propuesta en el que le gustaría trabajar, idealmente una que
19+
se pueda solucionar en poco tiempo.
20+
21+
<!-- prettier-ignore -->
22+
<a name="first-issue"></a>
23+
{{% alert title="Contribuyendo por la primera vez? " %}}
24+
25+
Seleccione una propuesta con las siguientes etiquetas:
26+
27+
- [Good first issue]
28+
- [Help wanted]
29+
30+
<!-- prettier-ignore -->
31+
> **NOTA**: **_No_ asignamos propuestas** a aquellos que aún no hayan contribuido a la organización [OpenTelemetry
32+
> organization][org], a menos que sean parte de un proceso de tutoria o onboarding.
33+
{.mt-3}
34+
35+
<!-- prettier-ignore -->
36+
[good first issue]: {{% param _issue %}}%22good+first+issue%22
37+
[help wanted]: {{% param _issue %}}%3A%22help+wanted%22
38+
[org]: https://github.com/open-telemetry
39+
40+
{{% /alert %}}
41+
42+
3. Lea los comentarios del problema, si los hay.
43+
4. Pregunta a los mantenedores si la propuesta sigue siendo relevante y aclara
44+
cualquier duda publicando un comentario.
45+
5. Comparte tu intención de trabajar en el tema agregando un comentario a este
46+
efecto.
47+
6. Trabaja para solucionar el problema y notifica a los mantenedores si surge
48+
algún inconveniente.
49+
7. Cuando este listo, [envia tu trabajo con un pull request](../pull-requests)
50+
(PR).
51+
52+
## Reportar un problema
53+
54+
Si encuentras un error o quieres hacer unas sugerencias para mejorar el
55+
contenido existente, abre una propuesta.
56+
57+
1. Haz click en el enlace **Crea una propuesta para la documentación** de
58+
cualquier documento. Eso te va a redireccionar a una pagina de la propuesta
59+
GitHub prerrellenada con algunos encabezados.
60+
2. Describa el problema o la sugerencia de mejora. Proporcione tantos detalles
61+
como pueda.
62+
3. Haz click en **Submit new issue**.
63+
64+
Después de enviar el problema, verifique su problema de vez en cuando o active
65+
las notificaciones de GitHub. Puede que pasen algunos días hasta que los
66+
mantenedores respondan. Los revisores y otros miembros de la comunidad pueden
67+
hacer preguntas antes de poder tomar medidas sobre su problema.
68+
69+
## Sugerir nuevos contenidos o funciones
70+
71+
Si tienes una idea para un nuevo contenido o funcionalidad, pero no estás seguro
72+
de dónde debería ir, aún puedes presentar una propuesta. También puedes informar
73+
errores y vulnerabilidades de seguridad.
74+
75+
1. Ve a [GitHub](https://github.com/open-telemetry/opentelemetry.io/issues/new/)
76+
y selecciona **Nueva propuesta** dentro de la pestaña **Propuestas**.
77+
78+
1. Seleccione el tipo de problema que mejor se aplica a su solicitud o duda.
79+
80+
1. Rellene la plantilla.
81+
82+
1. Envia la propuesta.
83+
84+
### Como crear buenas propuestas
85+
86+
Tenga en cuenta lo siguiente al crear una propuesta:
87+
88+
- Proporcione una descripción clara del problema. Describa específicamente qué
89+
falta, qué está desactualizado, qué está mal o qué necesita mejorarse.
90+
- Explique el impacto específico que tiene el problema en los usuarios.
91+
- Limite el alcance de un problema determinado a una unidad de trabajo
92+
razonable. En el caso de problemas de gran alcance, divídelos en tareas más
93+
pequeñas. Por ejemplo, "Corregir la documentación de seguridad" es demasiado
94+
amplio, pero "Agregar detalles en la sección 'Restringir el acceso a la red'"
95+
es lo suficientemente específico como para que se pueda llevar a cabo una
96+
acción.
97+
- Busque los problemas existentes para ver si hay algo relacionado o similar al
98+
nuevo problema.
99+
- Si el nuevo problema se relaciona con otro problema o solicitud de
100+
incorporación de cambios, haga referencia a él por su URL completa o por el
101+
número del problema o solicitud de incorporación de cambios precedido por el
102+
carácter `#`, por ejemplo `Introducido por #987654`.
103+
- Sigue el
104+
[Código de conducta](https://github.com/open-telemetry/community/blob/main/code-of-conduct.md).
105+
Respete a sus compañeros colaboradores. Por ejemplo, decir "Los documentos son
106+
terribles" no es un comentario útil ni cortés.

content/ja/docs/concepts/context-propagation.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: コンテキスト伝搬
33
weight: 10
44
description: 分散トレーシングを可能にする概念について学ぶ
5-
default_lang_commit: 313e391
5+
default_lang_commit: d2368c7e90e6abeb4580193aa305dfabd21ed4f7
66
---
77

8-
コンテキスト伝搬により、[シグナル](/docs/concepts/signals)は、それらが生成された場所に関係なく、互いを相関させられます。
9-
トレースに限ったことではありませんが、コンテキスト伝搬によって、[トレース](/docs/concepts/signals/traces)は、プロセスやネットワークの境界を越えて任意に分散しているサービス間で、システムに関する因果情報を構築できます。
8+
コンテキスト伝搬により、[シグナル](../signals/)は、それらが生成された場所に関係なく、互いを相関させられます。
9+
トレースに限ったことではありませんが、コンテキスト伝搬によって、[トレース](../signals/traces/)は、プロセスやネットワークの境界を越えて任意に分散しているサービス間で、システムに関する因果情報を構築できます。
1010

1111
コンテキストの伝播を理解するには、コンテキストと伝搬(プロパゲーション)という、2つの別々の概念を理解する必要があります。
1212

@@ -23,7 +23,7 @@ default_lang_commit: 313e391
2323
コンテキストオブジェクトをシリアライズまたはデシリアライズし、あるサービスから別のサービスに伝搬される関連情報を提供します。
2424

2525
伝播は通常、計装ライブラリによって処理され、ユーザーには透過的です。
26-
手動でコンテキストを伝播する必要がある場合は、伝搬APIを使用できます
26+
手動でコンテキストを伝播する必要がある場合は、[伝搬API](/docs/specs/otel/context/api-propagators/)を使用できます
2727

2828
OpenTelemetryはいくつかの公式プロパゲーターを保守しています。
2929
デフォルトのプロパゲーターは[W3C TraceContext](https://www.w3.org/TR/trace-context/)仕様で指定されたヘッダーを使用しています。

content/ja/docs/concepts/instrumentation/zero-code.md content/ja/docs/concepts/instrumentation/zero-code/index.md

+6-4
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,16 @@ title: ゼロコード
33
description: >-
44
コードを書かずにアプリケーションにオブザーバビリティを追加する方法を学ぶ
55
weight: 10
6-
default_lang_commit: d8c5612
6+
default_lang_commit: 35fde3d
77
---
88

99
[運用担当者](/docs/getting-started/ops/)として、ソースを編集することなく、1つ以上のアプリケーションにオブザーバビリティを追加したいと思うかもしれません。
10-
OpenTelemetry を使えば、[コードベースの計装](/docs/concepts/instrumentation/code-based) のための OpenTelemetry API & SDK を使わなくても、サービスのオブザーバビリティを素早く得られます。
10+
OpenTelemetry を使えば、[コードベースの計装](/docs/concepts/instrumentation/code-based) のための OpenTelemetry API SDK を使わなくても、サービスのオブザーバビリティを素早く得られます。
1111

12-
ゼロコード計装は、OpenTelemetry APIとSDKの機能を使って、通常、エージェントあるいはそれに準ずる機能をアプリケーションに追加します。
13-
具体的なメカニズムは言語によって異なり、バイトコード操作、モンキーパッチ、あるいはeBPFから、アプリケーションにOpenTelemetry APIとSDKへの呼び出しを注入します。
12+
![Zero Code](./zero-code.svg)
13+
14+
ゼロコード計装は、OpenTelemetry API と SDKの機能を使って、通常、エージェントあるいはそれに準ずる機能をアプリケーションに追加します。
15+
具体的なメカニズムは言語によって異なり、バイトコード操作、モンキーパッチ、あるいは eBPF から、アプリケーションにOpenTelemetry APIとSDKへの呼び出しを注入します。
1416

1517
通常、ゼロコード計装は、使用しているライブラリの計装を追加します。
1618
つまり、リクエストとレスポンス、データベース呼び出し、メッセージキュー呼び出しなどが計装の対象となります。

content/ja/docs/concepts/signals/_index.md

+15-3
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,27 @@
22
title: シグナル
33
description: OpenTelemetryがサポートするテレメトリーのカテゴリについて学ぶ
44
weight: 11
5-
default_lang_commit: 9b5e318
5+
default_lang_commit: 43ecc19b51fd86d5b2f30c638f6d734ee8b94932
66
---
77

88
OpenTelemetryの目的は、**[シグナル][signals]** を収集、処理、エクスポートすることです。
99
シグナルは、オペレーティングシステムやプラットフォーム上で動作しているアプリケーションの基本的な活動を記述するシステム出力です。
1010
シグナルは、温度やメモリ使用量のような特定の時点で測定したいもの、またはあなたが追跡したい分散システムのコンポーネントを通過するイベントです。
1111
異なるシグナルをグループ化して、同じテクノロジーの内部動作を異なる角度から観察することもできる。
1212

13-
OpenTelemetry は現在、[トレース](/docs/concepts/signals/traces)[メトリクス](/docs/concepts/signals/metrics)[ログ](/docs/concepts/signals/logs)[バゲッジ](/docs/concepts/signals/baggage)をサポートしています。
14-
_イベント_ は特定の種類のログで、_プロファイル_ はProfiling Working Groupによって[現在策定中](https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/profiles/0212-profiling-vision.md)です。
13+
OpenTelemetry は現在、下記をサポートしています。
1514

15+
- [トレース](traces)
16+
- [メトリクス](metrics)
17+
- [ログ](logs)
18+
- [バゲッジ](baggage)
19+
20+
同様に、下記は開発中または[提案][proposal]の段階です。
21+
22+
- [イベント][Events]は、特定の[ログ](logs)のタイプです。
23+
- [プロファイル][Profiles] は、Profiling Working Group によって現在策定中です。
24+
25+
[Events]: /docs/specs/otel/logs/data-model/#events
26+
[Profiles]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/profiles/0212-profiling-vision.md
27+
[proposal]: https://github.com/open-telemetry/opentelemetry-specification/tree/main/oteps/#readme
1628
[signals]: /docs/specs/otel/glossary/#signals

content/ja/docs/concepts/signals/metrics.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: メトリクス
33
weight: 2
44
description: 実行時に取得された測定値
5-
default_lang_commit: eb19d1dd5ab2f66343ec76adbfb31f81024da3a1
5+
default_lang_commit: f15873cbe9b2c3f3b51ef4629a6116de84eae08f
66
---
77

88
**メトリクス**とは、実行時に取得されるサービスの**測定値**のことです。
@@ -52,9 +52,9 @@ OpenTelemetryでは、計測は **メトリクス計装** によって行われ
5252
たとえば、キューの長さは、キュー内のワークアイテムの数によって増減します。
5353
- **Asynchronous UpDownCounter(非同期アップダウンカウンター)**: **アップダウンカウンター**と同じですが、各エクスポートに対して一度だけ収集されます。
5454
連続的な変更にアクセスできず、集約された値(たとえば、現在のキューのサイズ)のみにアクセスできる場合に使用できます。
55-
- **Gauge(ゲージ)**: 読み取った時点での現在の値を測定します。たとえば、自動車の燃料計など。ゲージは非同期です
55+
- **Gauge(ゲージ)**: 読み取った時点での現在の値を測定します。たとえば、自動車の燃料計など。ゲージは同期しています
5656
- **Asynchronous Gauge(非同期ゲージ)**: **ゲージ**と同じですが、各エクスポートに対して一度だけ収集されます。
57-
連続的な変更にアクセスできず、集約された値 のみにアクセスできる場合に使用できます
57+
連続的な変更にアクセスできず、集約された値のみにアクセスできる場合に使用できます
5858
- **Histogram(ヒストグラム)**: リクエストのレイテンシーなどの値をクライアント側で集約したもの。
5959
値の統計に興味がある場合は、ヒストグラムが良いでしょう。
6060
たとえば、どれくらいのリクエストが1秒未満か、といった疑問に答えてくれます。
@@ -69,7 +69,7 @@ OTLPプロトコルは、このような集約されたメトリクスを伝送
6969
OpenTelemetry APIは、各計装に対してデフォルトの集約を提供します。これはビューを使ってオーバーライドできます。
7070
OpenTelemetryプロジェクトは、ビジュアライザーやテレメトリーバックエンドでサポートされるデフォルトの集計を提供することを目指しています。
7171

72-
[リクエストトレース](/docs/concepts/signals/traces/)が、リクエストのライフサイクルを捕捉し、リクエストの個々の部分にコンテキストを提供することを意図しているのとは異なり、メトリクスは、集約された統計情報を提供することを意図しています。
72+
[リクエストトレース](../traces/)が、リクエストのライフサイクルを捕捉し、リクエストの個々の部分にコンテキストを提供することを意図しているのとは異なり、メトリクスは、集約された統計情報を提供することを意図しています。
7373
メトリクスの使用例には、次のようなものがあります。
7474

7575
- プロトコルの種類ごとに、サービスによって読み取られた総バイト数を報告する。

0 commit comments

Comments
 (0)