Add Japanese translation: OpenTelemetry Collector Workshops

content/ja/ninja-workshops/3-opentelemetry-collector-workshops/1-opentelemetry-collector/1-installation/1-confirmation.md

@@ -0,0 +1,310 @@
+---
+title: OpenTelemetry Collector Contrib のインストール
+linkTitle: 1.1 インストールの確認
+weight: 1
+---
+
+## Collector が動作していることを確認する
+
+Collector が動作しているはずです。`systemctl` コマンドを使用して root として確認します。ステータス表示を終了するには `q` を押してください。
+
+{{< tabs >}}
+{{% tab title="コマンド" %}}
+
+``` bash
+sudo systemctl status otelcol-contrib
+```
+
+{{% /tab %}}
+{{% tab title="ステータス出力" %}}
+
+``` text
+● otelcol-contrib.service - OpenTelemetry Collector Contrib
+     Loaded: loaded (/lib/systemd/system/otelcol-contrib.service; enabled; vendor preset: enabled)
+     Active: active (running) since Mon 2024-10-07 10:27:49 BST; 52s ago
+   Main PID: 17113 (otelcol-contrib)
+      Tasks: 13 (limit: 19238)
+     Memory: 34.8M
+        CPU: 155ms
+     CGroup: /system.slice/otelcol-contrib.service
+             └─17113 /usr/bin/otelcol-contrib --config=/etc/otelcol-contrib/config.yaml
+
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]: Descriptor:
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]:      -> Name: up
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]:      -> Description: The scraping was successful
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]:      -> Unit:
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]:      -> DataType: Gauge
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]: NumberDataPoints #0
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]: StartTimestamp: 1970-01-01 00:00:00 +0000 UTC
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]: Timestamp: 2024-10-07 09:28:36.942 +0000 UTC
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]: Value: 1.000000
+Oct 07 10:28:36 petclinic-rum-testing otelcol-contrib[17113]:         {"kind": "exporter", "data_type": "metrics", "name": "debug"}
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+このワークショップでは、設定ファイルの変更、環境変数の設定、Collector の再起動を複数回行うため、Collector サービスを停止し、起動時の自動起動を無効にする必要があります。
+
+{{< tabs >}}
+{{% tab title="コマンド" %}}
+
+``` bash
+sudo systemctl stop otelcol-contrib && sudo systemctl disable otelcol-contrib
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+---
+
+{{% expand title="{{% badge style=primary icon=user-ninja %}}**Ninja:** Open Telemetry Collector Builder (ocb) を使用して独自の Collector をビルドする{{% /badge %}}" %}}
+このパートでは、システムに以下がインストールされている必要があります
+
+- Golang（最新バージョン）
+
+  ``` bash
+  cd /tmp
+  wget https://golang.org/dl/go1.20.linux-amd64.tar.gz
+  sudo tar -C /usr/local -xzf go1.20.linux-amd64.tar.gz
+  ```
+
+  `.profile` を編集して、以下の環境変数を追加します
+
+  ``` bash
+  export GOROOT=/usr/local/go
+  export GOPATH=$HOME/go
+  export PATH=$GOPATH/bin:$GOROOT/bin:$PATH
+  ```
+
+  シェルセッションを更新します
+
+  ``` bash
+  source ~/.profile
+  ```
+
+  Go のバージョンを確認します
+
+  ``` bash
+  go version
+  ```
+
+- ocb のインストール
+  - [プロジェクトリリース](https://github.com/open-telemetry/opentelemetry-collector/releases/tag/cmd%2Fbuilder%2Fv0.80.0)から ocb バイナリをダウンロードし、以下のコマンドを実行します
+
+    ```bash
+    mv ocb_0.80.0_darwin_arm64 /usr/bin/ocb
+    chmod 755 /usr/bin/ocb
+    ```
+
+    別の方法として、golang ツールチェーンを使用してローカルでバイナリをビルドすることもできます
+
+    ```bash
+    go install go.opentelemetry.io/collector/cmd/builder@v0.80.0
+    mv $(go env GOPATH)/bin/builder /usr/bin/ocb
+    ```
+
+- （オプション）Docker
+
+## なぜ独自の Collector をビルドするのか？
+
+Collector のデフォルトディストリビューション（core と contrib）は、提供する機能が多すぎるか少なすぎるかのどちらかです。
+
+また、contrib Collector を本番環境で実行することは推奨されません。これは、インストールされるコンポーネントの量が多く、そのほとんどがデプロイメントに必要ないためです。
+
+## 独自の Collector をビルドするメリットは？
+
+独自の Collector バイナリ（一般的にディストリビューションと呼ばれる）を作成することは、必要なものだけをビルドすることを意味します。
+
+これには以下のメリットがあります
+
+1. より小さなサイズのバイナリ
+2. 脆弱性に対して既存の Go スキャナーを使用できる
+3. 組織と連携できる内部コンポーネントを含めることができる
+
+## Collector をビルドする際の考慮事項は？
+
+さて、いくつかのデメリットがなければ 🥷 Ninja ゾーンとは言えません
+
+1. Go の経験が推奨される（必須ではないが）
+1. Splunk サポート**なし**
+1. ディストリビューションとライフサイクル管理の責任
+
+プロジェクトは安定性に向けて取り組んでいますが、変更によってワークフローが壊れないとは限らないことに注意することが重要です。Splunk のチームは、より高いサポートと安定性を提供しており、デプロイメントのニーズに応じたキュレーションされた体験を提供できます。
+
+## Ninja ゾーン
+
+必要なツールがすべてインストールされたら、`otelcol-builder.yaml` という名前の新しいファイルを作成し、以下のディレクトリ構造に従います
+
+``` bash
+.
+└── otelcol-builder.yaml
+```
+
+ファイルを作成したら、いくつかの追加メタデータとともにインストールするコンポーネントのリストを追加する必要があります。
+
+この例では、入門用の設定に必要なコンポーネントのみをインストールするビルダーマニフェストを作成します
+
+```yaml
+dist:
+  name: otelcol-ninja
+  description: A custom build of the Open Telemetry Collector
+  output_path: ./dist
+
+extensions:
+- gomod: go.opentelemetry.io/collector/extension/ballastextension v0.80.0
+- gomod: go.opentelemetry.io/collector/extension/zpagesextension  v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/extension/httpforwarder v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/extension/healthcheckextension v0.80.0
+
+exporters:
+- gomod: go.opentelemetry.io/collector/exporter/loggingexporter v0.80.0
+- gomod: go.opentelemetry.io/collector/exporter/otlpexporter v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/splunkhecexporter v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/signalfxexporter v0.80.0
+
+processors:
+- gomod: go.opentelemetry.io/collector/processor/batchprocessor v0.80.0
+- gomod: go.opentelemetry.io/collector/processor/memorylimiterprocessor v0.80.0
+
+receivers:
+- gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/jaegerreceiver v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver v0.80.0
+- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/zipkinreceiver v0.80.0
+```
+
+yaml ファイルが _ocb_ 用に更新されたら、以下のコマンドを実行します
+
+```shell
+ocb --config=otelcol-builder.yaml
+```
+
+これにより、以下のディレクトリ構造が作成されます
+
+``` text
+├── dist
+│   ├── components.go
+│   ├── components_test.go
+│   ├── go.mod
+│   ├── go.sum
+│   ├── main.go
+│   ├── main_others.go
+│   ├── main_windows.go
+│   └── otelcol-ninja
+└── otelcol-builder.yaml
+```
+
+### 参考資料
+
+1. [https://opentelemetry.io/docs/collector/custom-collector/](https://opentelemetry.io/docs/collector/custom-collector/)
+
+{{% /expand %}}
+
+---
+
+## デフォルト設定
+
+OpenTelemetry は YAML ファイルを通じて設定されます。これらのファイルには、ニーズに合わせて変更できるデフォルト設定があります。提供されるデフォルト設定を見てみましょう
+
+{{< tabs >}}
+{{% tab title="コマンド" %}}
+
+```bash
+cat /etc/otelcol-contrib/config.yaml
+```
+
+{{% /tab %}}
+{{% tab title="config.yaml" %}}
+
+```yaml { lineNos="table" wrap="true"}
+# To limit exposure to denial of service attacks, change the host in endpoints below from 0.0.0.0 to a specific network interface.
+# See https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/security-best-practices.md#safeguards-against-denial-of-service-attacks
+
+extensions:
+  health_check:
+  pprof:
+    endpoint: 0.0.0.0:1777
+  zpages:
+    endpoint: 0.0.0.0:55679
+
+receivers:
+  otlp:
+    protocols:
+      grpc:
+        endpoint: 0.0.0.0:4317
+      http:
+        endpoint: 0.0.0.0:4318
+
+  opencensus:
+    endpoint: 0.0.0.0:55678
+
+  # Collect own metrics
+  prometheus:
+    config:
+      scrape_configs:
+      - job_name: 'otel-collector'
+        scrape_interval: 10s
+        static_configs:
+        - targets: ['0.0.0.0:8888']
+
+  jaeger:
+    protocols:
+      grpc:
+        endpoint: 0.0.0.0:14250
+      thrift_binary:
+        endpoint: 0.0.0.0:6832
+      thrift_compact:
+        endpoint: 0.0.0.0:6831
+      thrift_http:
+        endpoint: 0.0.0.0:14268
+
+  zipkin:
+    endpoint: 0.0.0.0:9411
+
+processors:
+  batch:
+
+exporters:
+  debug:
+    verbosity: detailed
+
+service:
+
+  pipelines:
+
+    traces:
+      receivers: [otlp, opencensus, jaeger, zipkin]
+      processors: [batch]
+      exporters: [debug]
+
+    metrics:
+      receivers: [otlp, opencensus, prometheus]
+      processors: [batch]
+      exporters: [debug]
+
+    logs:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]
+
+  extensions: [health_check, pprof, zpages]
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+おめでとうございます！OpenTelemetry Collector のダウンロードとインストールに成功しました。OTel Ninja への道を順調に歩んでいます。しかしまず、設定ファイルと OpenTelemetry Collector の異なるディストリビューションについて説明していきましょう。
+
+{{% notice style="note" %}}
+
+Splunk は独自の、完全にサポートされた OpenTelemetry Collector ディストリビューションを提供しています。このディストリビューションは、[**Splunk GitHub リポジトリ**](https://github.com/signalfx/splunk-otel-collector)からインストールするか、Splunk Observability Cloud のウィザードを使用してコピー＆ペーストするだけの簡単なインストールスクリプトを作成できます。このディストリビューションには、OpenTelemetry Collector Contrib ディストリビューションでは利用できない多くの追加機能と拡張が含まれています。
+
+- Splunk Distribution of the OpenTelemetry Collector は本番環境でテスト済みです。大多数のお客様が本番環境で使用しています。
+- このディストリビューションを使用するお客様は、SLA 内で Splunk の公式サポートから直接サポートを受けることができます。
+- お客様は、メトリクスとトレース収集のコア設定体験に対する将来の破壊的変更を心配することなく、Splunk Distribution of the OpenTelemetry Collector を使用または移行できます（OpenTelemetry ログ収集の設定はベータ版です）。Collector のメトリクスには破壊的変更がある可能性があります。
+
+{{% /notice %}}
+
+これから設定ファイルの各セクションを説明し、ホストメトリクスを Splunk Observability Cloud に送信するように変更していきます。

content/ja/ninja-workshops/3-opentelemetry-collector-workshops/1-opentelemetry-collector/1-installation/_index.md

@@ -0,0 +1,41 @@
+---
+title: OpenTelemetry Collector Contrib のインストール
+linkTitle: 1. インストール
+weight: 1
+---
+
+## OpenTelemetry Collector Contrib ディストリビューションのダウンロード
+
+OpenTelemetry Collector をインストールする最初のステップは、ダウンロードです。このラボでは、`wget` コマンドを使用して OpenTelemetry の GitHub リポジトリから `.deb` パッケージをダウンロードします。
+
+お使いのプラットフォーム用の `.deb` パッケージを [**OpenTelemetry Collector Contrib リリースページ**](https://github.com/open-telemetry/opentelemetry-collector-releases/releases) から取得します。
+
+``` bash
+wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.111.0/otelcol-contrib_0.111.0_linux_amd64.deb
+```
+
+## OpenTelemetry Collector Contrib ディストリビューションのインストール
+
+`dpkg` を使用して `.deb` パッケージをインストールします。インストールが成功した場合の出力例は、下の **dpkg Output** タブを確認してください
+
+{{< tabs >}}
+{{% tab title="インストール" %}}
+
+``` bash
+sudo dpkg -i otelcol-contrib_0.111.0_linux_amd64.deb
+```
+
+{{% /tab %}}
+{{% tab title="dpkg 出力" %}}
+
+``` text
+Selecting previously unselected package otelcol-contrib.
+(Reading database ... 89232 files and directories currently installed.)
+Preparing to unpack otelcol-contrib_0.111.0_linux_amd64.deb ...
+Unpacking otelcol-contrib (0.111.0) ...
+Setting up otelcol-contrib (0.111.0) ...
+Created symlink /etc/systemd/system/multi-user.target.wants/otelcol-contrib.service → /lib/systemd/system/otelcol-contrib.service.
+```
+
+{{% /tab %}}
+{{< /tabs >}}