Skip to content

[ja] docs(i18n): translate content/en/docs/languages/js/*.md files #7164

New issue

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

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

Already on GitHub? Sign in to your account

Open
wants to merge 19 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
9e78a09
docs(i18n): translate content/en/docs/languages/js/_index.mdinto ja
Msksgm Jun 22, 2025
8503ca7
docs(i18n): translate content/ja/docs/languages/js/getting-started/_i…
Msksgm Jun 22, 2025
b98ee17
docs(i18n): translate content/ja/docs/languages/js/getting-started/no…
Msksgm Jun 22, 2025
79d3889
docs(i18n): translate content/ja/docs/languages/js/getting-started/br…
Msksgm Jun 22, 2025
f1dba6f
docs(i18n): translate content/en/docs/languages/js/instrumentation.md…
Msksgm Jun 22, 2025
e830db4
docs(i18n): translate content/ja/docs/languages/js/libraries.md into ja
Msksgm Jun 22, 2025
3e0fe4b
docs(i18n): translate content/ja/docs/languages/js/exporters.md into ja
Msksgm Jun 22, 2025
b102129
docs(i18n): translate content/ja/docs/languages/js/context.md into ja
Msksgm Jun 22, 2025
b9967cb
docs(i18n): translate content/ja/docs/languages/js/propagation.md int…
Msksgm Jun 22, 2025
fd137b6
docs(i18n): translate content/ja/docs/languages/js/resources.md into ja
Msksgm Jun 22, 2025
915f81b
docs(i18n): translate content/ja/docs/languages/js/sampling.md into ja
Msksgm Jun 22, 2025
2b1cd1b
docs(i18n): translate content/ja/docs/languages/js/serverless.md into ja
Msksgm Jun 22, 2025
8c2c945
docs(i18n): translate content/ja/docs/languages/js/benchmarks.md into ja
Msksgm Jun 22, 2025
e9c3750
fixup! docs(i18n): translate content/ja/docs/languages/js/context.md …
Msksgm Jun 22, 2025
7bf41af
fixup! docs(i18n): translate content/ja/docs/languages/js/exporters.m…
Msksgm Jun 22, 2025
d70cbd9
fixup! docs(i18n): translate content/ja/docs/languages/js/exporters.m…
Msksgm Jun 22, 2025
8c37fae
fixup! docs(i18n): translate content/ja/docs/languages/js/exporters.m…
Msksgm Jun 22, 2025
d51762e
fixup! docs(i18n): translate content/ja/docs/languages/js/propagation…
Msksgm Jun 22, 2025
c44adb1
fixup! docs(i18n): translate content/ja/docs/languages/js/propagation…
Msksgm Jun 22, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions content/ja/docs/languages/_includes/exporters/jaeger.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

## Jaeger {#jaeger}

### バックエンドのセットアップ {#jaeger-backend-setup}

[Jaeger](https://www.jaegertracing.io/)は、トレースデータを受信するためにOTLPをネイティブでサポートしています。UIがポート16686でアクセス可能で、OTLPがポート4317と4318で有効になったDockerコンテナでJaegerを実行できます。

```shell
docker run --rm \
-e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
-p 16686:16686 \
-p 4317:4317 \
-p 4318:4318 \
-p 9411:9411 \
jaegertracing/all-in-one:latest
```

### 使用方法 {#jaeger-usage}

[OTLPエクスポーター](#otlp-dependencies)をセットアップするための手順に従ってください。
13 changes: 13 additions & 0 deletions content/ja/docs/languages/_includes/exporters/outro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

## カスタムエクスポーター {#custom-exporters}

最後に、独自のエクスポーターを作成することもできます。
詳細については、[APIドキュメントのSpanExporterインターフェース]({{ $1 }})を参照してください。

## スパンとログレコードのバッチ処理 {#batching-span-and-log-records}

OpenTelemetry SDKは、スパンを1つずつ発行する(「シンプル」)か、バッチで発行するかを選択できるデフォルトのスパンプロセッサーとログレコードプロセッサーのセットを提供しています。
バッチ処理の使用が推奨されますが、スパンやログレコードをバッチ処理したくない場合は、かわりに以下のようにシンプルプロセッサーを使用できます。
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

## Prometheus {#prometheus}

メトリクスデータを[Prometheus](https://prometheus.io/)に送信するには、[PrometheusのOTLPレシーバーを有効にして](https://prometheus.io/docs/prometheus/2.55/feature_flags/#otlp-receiver)[OTLPエクスポーター](#otlp)を使用するか、Prometheusエクスポーターを使用できます。
Prometheusエクスポーターは、メトリクスを収集しリクエストに応じてPrometheusテキスト形式にシリアライズするHTTPサーバーを起動する`MetricReader`です。

### バックエンドのセットアップ {#prometheus-setup}

{{% alert title=注意 %}}

すでにPrometheusまたはPrometheus互換のバックエンドをセットアップしている場合は、このセクションをスキップして、アプリケーション用の[Prometheus](#prometheus-dependencies)または[OTLP](#otlp-dependencies)エクスポーターの依存関係をセットアップしてください。

{{% /alert %}}

[Prometheus](https://prometheus.io)をDockerコンテナで実行し、ポート`9090`でアクセスできるようにするには、以下の手順に従ってください。

以下の内容で`prometheus.yml`というファイルを作成します。

```yaml
scrape_configs:
- job_name: dice-service
scrape_interval: 5s
static_configs:
- targets: [host.docker.internal:9464]
```

UIがポート`9090`でアクセス可能なDockerコンテナでPrometheusを実行します。

```shell
docker run --rm -v ${PWD}/prometheus.yml:/prometheus/prometheus.yml -p 9090:9090 prom/prometheus --enable-feature=otlp-write-receive
```

{{% alert title=注意 %}}

PrometheusのOTLPレシーバーを使用する場合は、アプリケーションでメトリクス用のOTLPエンドポイントを`http://localhost:9090/api/v1/otlp`に設定してください。

すべてのDocker環境が`host.docker.internal`をサポートしているわけではありません。場合によっては、`host.docker.internal`を`localhost`またはマシンのIPアドレスに置き換える必要があるかもしれません。

{{% /alert %}}
19 changes: 19 additions & 0 deletions content/ja/docs/languages/_includes/exporters/zipkin-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

## Zipkin {#zipkin}

### バックエンドのセットアップ {#zipkin-setup}

{{% alert title=注意 %}}

すでにZipkinまたはZipkin互換のバックエンドをセットアップしている場合は、このセクションをスキップして、アプリケーション用の[Zipkinエクスポーターの依存関係](#zipkin-dependencies)をセットアップしてください。

{{% /alert %}}

以下のコマンドを実行して、[Zipkin](https://zipkin.io/)をDockerコンテナで実行できます。

```shell
docker run --rm -d -p 9411:9411 --name zipkin openzipkin/zipkin
```
16 changes: 16 additions & 0 deletions content/ja/docs/languages/_includes/instrumentation-intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

[計装](/docs/concepts/instrumentation/)は、アプリに自分でオブザーバビリティコードを追加する行為です。

アプリを計装している場合は、その言語のOpenTelemetry SDKを使用する必要があります。
次に、SDKを使用してOpenTelemetryを初期化し、APIを使用してコードを計装します。
これにより、アプリから、および計装も付属しているインストール済みライブラリからテレメトリーが発行されます。

ライブラリを計装している場合は、その言語のOpenTelemetry APIパッケージのみをインストールしてください。
ライブラリは単独ではテレメトリーを発行しません。
OpenTelemetry SDKを使用するアプリの一部である場合にのみテレメトリーを発行します。
ライブラリの計装の詳細については、[ライブラリ](/docs/concepts/instrumentation/libraries/)を参照してください。

OpenTelemetry APIとSDKの詳細については、[仕様](/docs/specs/otel/)を参照してください。
10 changes: 10 additions & 0 deletions content/ja/docs/languages/_includes/span-status-preamble.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

[ステータス](/docs/concepts/signals/traces/#span-status)は[スパン](/docs/concepts/signals/traces/#spans)に設定でき、通常はスパンが正常に完了しなかったことを示すために使用されます。
つまり`Error`です。
デフォルトでは、すべてのスパンは`Unset`であり、これはスパンがエラーなく完了したことを意味します。
`Ok`ステータスは、デフォルトの`Unset`(つまり「エラーなし」)のままにするのではなく、スパンを明示的に成功としてマークする必要がある場合に予約されています。

ステータスは、スパンが終了する前であればいつでも設定できます。
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

{{% alert title=警告 color=warning %}}

ブラウザ向けのクライアント計装は**実験的**であり、主に**未規定**です。協力に興味をお持ちの場合は、[Client Instrumentation SIG][sig]までご連絡ください。

[sig]: https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w

{{% /alert %}}
39 changes: 39 additions & 0 deletions content/ja/docs/languages/js/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: JavaScript
description: >-
<img width="35" class="img-initial" src="/img/logos/32x32/JS_SDK.svg"
alt="JavaScript"> JavaScript(Node.jsとブラウザ向け)でのOpenTelemetryの言語固有実装。
aliases: [/js, /js/metrics, /js/tracing]
weight: 20
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
---

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

{{% include browser-instrumentation-warning.md %}}

## バージョンサポート {#version-support}

OpenTelemetry JavaScriptは、Node.jsのすべてのアクティブまたはメンテナンスLTSバージョンをサポートしています。
以前のNode.jsバージョンは動作する可能性がありますが、OpenTelemetryでテストされていません。

OpenTelemetry JavaScriptには、ブラウザの公式サポートリストはありません。
主要ブラウザの現在サポートされているバージョンで動作することを目指しています。

OpenTelemetry JavaScriptは、TypeScriptについてDefinitelyTypeのサポートポリシーに従い、2年のサポートウィンドウを設定しています。
2年より古いTypeScriptバージョンのサポートは、OpenTelemetry JavaScriptのマイナーリリースで削除されます。

ランタイムサポートの詳細については、[この概要](https://github.com/open-telemetry/opentelemetry-js#supported-runtimes)を参照してください。

## リポジトリ {#repositories}

OpenTelemetry JavaScriptは以下のリポジトリで構成されています。

- [opentelemetry-js](https://github.com/open-telemetry/opentelemetry-js)、コア配布APIとSDKを含むコアリポジトリ。
- [opentelemetry-js-contrib](https://github.com/open-telemetry/opentelemetry-js-contrib)、APIとSDKのコア配布の一部ではないコントリビューション。

## ヘルプまたはフィードバック {#help-or-feedback}

OpenTelemetry JavaScriptについて質問がある場合は、[GitHub Discussions](https://github.com/open-telemetry/opentelemetry-js/discussions)または[CNCF Slack](https://slack.cncf.io/)の[#otel-js]チャンネルまでお問い合わせください。

OpenTelemetry JavaScriptに貢献したい場合は、[貢献手順](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md)を参照してください。
188 changes: 188 additions & 0 deletions content/ja/docs/languages/js/benchmarks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,188 @@
---
title: ベンチマーク
weight: 101
default_lang_commit: 6f3712c5cda4ea79f75fb410521880396ca30c91
cSpell:ignore: Elems rrggbbaa
---

<link rel="stylesheet" href="/css/benchmarks.css">

OpenTelemetry JavaScript SDKは、[opentelemetry-js](https://github.com/open-telemetry/opentelemetry-js/)リポジトリへの各コミットでベンチマークテストを実行します。
これらのテストの目的は、重要な操作のパフォーマンス傾向を時間の経過とともに追跡することです。
これらのテストは、エンドツーエンドのパフォーマンステストの代替ではありません。

<div class="container">
<main id="main"></main>
</div>

<footer>
<button id="dl-button">JSONとしてデータをダウンロード</button>
<div class="spacer"></div>
<div class="small"><a rel="noopener"
href="https://github.com/marketplace/actions/continuous-benchmark">github-action-benchmark</a>によって動作</div>
</footer>

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/Chart.min.js"></script>
<script src="https://open-telemetry.github.io/opentelemetry-js/benchmarks/data.js"></script>
<script id="main-script">
'use strict';
(function() {
const COLORS = [
"#48aaf9",
"#8a3ef2",
"#78eeda",
"#d78000",
"#1248b3",
"#97dbfc",
"#006174",
"#00b6b6",
"#854200",
"#f3c8ad",
"#410472",
];

function init() {
function collectBenchesPerTestCase(entries) {
const map = new Map();
for (const entry of entries) {
const {commit, date, tool, benches} = entry;
for (const bench of benches) {
const result = { commit, date, tool, bench };
const arr = map.get(bench.name);
if (arr === undefined) {
map.set(bench.name, [result]);
} else {
arr.push(result);
}
}
}
return map;
}

const data = window.BENCHMARK_DATA;

// Render footer
document.getElementById('dl-button').onclick = () => {
const dataUrl = 'data:,' + JSON.stringify(data, null, 2);
const a = document.createElement('a');
a.href = dataUrl;
a.download = 'benchmark_data.json';
a.click();
};

// Prepare data points for charts
return Object.keys(data.entries).map(name => ({
name,
dataSet: collectBenchesPerTestCase(data.entries[name]),
}));
}

function renderAllChars(dataSets) {

function renderGraph(parent, name, dataset) {
const chartTitle = document.createElement('h3');
chartTitle.textContent = name;
parent.append(chartTitle);

const canvas = document.createElement('canvas');
canvas.className = 'benchmark-chart';
parent.appendChild(canvas);

const color = COLORS[0];
const data = {
labels: dataset.map(d => d.commit.id.slice(0, 7)),
datasets: [
{
label: name,
data: dataset.map(d => d.bench.value),
borderColor: color,
backgroundColor: color + '60', // Add alpha for #rrggbbaa,
fill: false
}
],
};
const options = {
scales: {
xAxes: [
{
scaleLabel: {
display: true,
labelString: 'commit',
},
}
],
yAxes: [
{
scaleLabel: {
display: true,
labelString: dataset.length > 0 ? dataset[0].bench.unit : '',
},
ticks: {
beginAtZero: true,
}
}
],
},
tooltips: {
callbacks: {
afterTitle: items => {
const {index} = items[0];
const data = dataset[index];
return '\n' + data.commit.message + '\n\n' + data.commit.timestamp + ' committed by @' + data.commit.committer.username + '\n';
},
label: item => {
let label = item.value;
const { range, unit } = dataset[item.index].bench;
label += ' ' + unit;
if (range) {
label += ' (' + range + ')';
}
return label;
},
afterLabel: item => {
const { extra } = dataset[item.index].bench;
return extra ? '\n' + extra : '';
}
}
},
onClick: (_mouseEvent, activeElems) => {
if (activeElems.length === 0) {
return;
}
// XXX: Undocumented. How can we know the index?
const index = activeElems[0]._index;
const url = dataset[index].commit.url;
window.open(url, '_blank');
},
};

new Chart(canvas, {
type: 'line',
data,
options,
});
}

function renderBenchSet(name, benchSet, main) {
const setElem = document.createElement('div');
setElem.className = 'benchmark-set';
main.appendChild(setElem);

const graphsElem = document.createElement('div');
graphsElem.className = 'benchmark-graphs';
setElem.appendChild(graphsElem);

for (const [benchName, benches] of benchSet.entries()) {
renderGraph(graphsElem, benchName, benches)
}
}

const main = document.getElementById('main');
for (const {name, dataSet} of dataSets) {
renderBenchSet(name, dataSet, main);
}
}

renderAllChars(init()); // Start
})();
</script>
Loading