追加翻訳

Author: gentksb

content/ja/ninja-workshops/8-docker-k8s-otel/10-troubleshoot-collector.md

@@ -186,8 +186,8 @@ kubectl logs -l component=otel-collector-agent -f
 次のようなものが表示されるはずです：
 
 ```
-2024-12-20T21:56:30.858Z	info	Logs	{"kind": "exporter", "data_type": "logs", "name": "debug", "resource logs": 1, "log records": 1}
-2024-12-20T21:56:30.858Z	info	ResourceLog #0
+2024-12-20T21:56:30.858Z info Logs {"kind": "exporter", "data_type": "logs", "name": "debug", "resource logs": 1, "log records": 1}
+2024-12-20T21:56:30.858Z info ResourceLog #0
 Resource SchemaURL: https://opentelemetry.io/schemas/1.6.1
 Resource attributes:
      -> splunk.distro.version: Str(1.8.0)
@@ -226,7 +226,7 @@ Attributes:
 Trace ID: 78db97a12b942c0252d7438d6b045447
 Span ID: 5e9158aa42f96db3
 Flags: 1
-	{"kind": "exporter", "data_type": "logs", "name": "debug"}
+ {"kind": "exporter", "data_type": "logs", "name": "debug"}
 ```
 
 この例では、Trace ID と Span ID が

content/ja/ninja-workshops/8-docker-k8s-otel/2-deploy-collector.md

@@ -1,6 +1,6 @@
 ---
 title: OpenTelemetryコレクターのデプロイ
-linkTitle: OpenTelemetryコレクターのデプロイ
+linkTitle: 2. OpenTelemetryコレクターのデプロイ
 weight: 2
 time: 10 minutes
 ---

content/ja/ninja-workshops/8-docker-k8s-otel/4-instrument-app-with-otel.md

@@ -49,9 +49,9 @@ Downloading v1.8.0 for linux-glibc (/tmp/tmp.m3tSdtbmge/splunk-opentelemetry-dot
 > ARCHITECTURE=x64 sh ./splunk-otel-dotnet-install.sh
 > ```
 
-## インストゥルメンテーションの有効化
+## 計装の有効化
 
-次に、OpenTelemetry インストゥルメンテーションを有効化できます：
+次に、OpenTelemetry 計装を有効化できます：
 
 ```bash
 . $HOME/.splunk-otel-dotnet/instrument.sh
@@ -66,7 +66,7 @@ Downloading v1.8.0 for linux-glibc (/tmp/tmp.m3tSdtbmge/splunk-opentelemetry-dot
 export OTEL_RESOURCE_ATTRIBUTES=deployment.environment=otel-$INSTANCE
 ```
 
-## インストゥルメンテーションを使用したアプリケーションの実行
+## 計装を使用したアプリケーションの実行
 
 以下のようにアプリケーションを実行できます：
 

content/ja/ninja-workshops/8-docker-k8s-otel/5-dockerize-app.md

@@ -110,23 +110,23 @@ WORKDIR /app
 EXPOSE 8080
 ```
 
-Note that the `mcr.microsoft.com/dotnet/aspnet:8.0` image includes the .NET runtime only,
-rather than the SDK, so is relatively lightweight. It's based off of the Debian 12 Linux
-distribution. You can find more information about the ASP.NET Core Runtime Docker images
-in [GitHub](https://github.com/dotnet/dotnet-docker/blob/main/README.aspnet.md).
+なお、`mcr.microsoft.com/dotnet/aspnet:8.0`イメージには.NET runtime のみが含まれており、
+SDK は含まれていないため、比較的軽量です。これは Debian 12 Linux
+distribution がベースになっています。ASP.NET Core Runtime Docker イメージの詳細については
+[GitHub](https://github.com/dotnet/dotnet-docker/blob/main/README.aspnet.md)で確認できます。
 
-### The Build Stage
+### Build ステージ
 
-The next stage of the Dockerfile is the build stage. For this stage, the
-`mcr.microsoft.com/dotnet/sdk:8.0` image is used, which is also based off of
-Debian 12 but includes the full [.NET SDK](https://github.com/dotnet/dotnet-docker/blob/main/README.sdk.md) rather than just the runtime.
+Dockerfile の次のステージは build ステージです。このステージでは、
+`mcr.microsoft.com/dotnet/sdk:8.0`イメージが使用されます。これも Debian 12 がベースになっていますが、
+runtime だけでなく完全な[.NET SDK](https://github.com/dotnet/dotnet-docker/blob/main/README.sdk.md)が含まれています。
 
-This stage copies the `.csproj` file to the build image, and then uses `dotnet restore` to
-download any dependencies used by the application.
+このステージでは`.csproj`ファイルを build イメージにコピーし、その後`dotnet restore`を使用して
+アプリケーションが使用する依存関係をダウンロードします。
 
-It then copies the application code to the build image and
-uses `dotnet build` to build the project and its dependencies into a
-set of `.dll` binaries:
+次に、アプリケーションコードを build イメージにコピーし、
+`dotnet build`を使用してプロジェクトとその依存関係を
+`.dll`バイナリのセットにビルドします：
 
 ```dockerfile
 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
@@ -139,22 +139,22 @@ COPY . .
 RUN dotnet build "./helloworld.csproj" -c $BUILD_CONFIGURATION -o /app/build
 ```
 
-### The Publish Stage
+### Publish ステージ
 
-The third stage is publish, which is based on build stage image rather than a Microsoft image. In this stage, `dotnet publish` is used to
-package the application and its dependencies for deployment:
+3 番目のステージは publish で、これは Microsoft イメージではなく build ステージイメージをベースにしています。このステージでは、`dotnet publish`を使用して
+アプリケーションとその依存関係を deployment 用にパッケージ化します：
 
 ```dockerfile
 FROM build AS publish
 ARG BUILD_CONFIGURATION=Release
 RUN dotnet publish "./helloworld.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
 ```
 
-### The Final Stage
+### Final ステージ
 
-The fourth stage is our final stage, which is based on the base
-stage image (which is lighter-weight than the build and publish stages). It copies the output from the publish stage image and
-defines the entry point for our application:
+4 番目のステージは最終ステージで、これは base
+ステージイメージをベースにしています（build と publish ステージよりも軽量）。publish ステージイメージからの出力をコピーし、
+アプリケーションの entry point を定義します：
 
 ```dockerfile
 FROM base AS final

content/ja/ninja-workshops/8-docker-k8s-otel/6-add-instrumentation-to-dockerfile.md

@@ -1,11 +1,11 @@
 ---
-title: DockerfileにInstrumentationを追加する
-linkTitle: 6. DockerfileにInstrumentationを追加する
+title: Dockerfileに計装を追加する
+linkTitle: 6. Dockerfileに計装を追加する
 weight: 6
 time: 10 minutes
 ---
 
-アプリケーションを正常に Docker 化したので、次に OpenTelemetry instrumentation を追加しましょう。
+アプリケーションを正常に Docker 化したので、次に OpenTelemetry による計装 を追加しましょう。
 
 これは、Linux で実行しているアプリケーションを計装した際の手順と似ていますが、
 注意すべきいくつかの重要な違いがあります。
@@ -27,7 +27,6 @@ vi /home/splunk/workshop/docker-k8s-otel/helloworld/Dockerfile
 ```
 
 > vi では「i」キーを押して編集モードに入ります
-
 > 'NEW CODE'とマークされている行を Dockerfile のビルドステージセクションに貼り付けてください：
 
 ```dockerfile
@@ -43,7 +42,7 @@ RUN dotnet build "./helloworld.csproj" -c $BUILD_CONFIGURATION -o /app/build
 
 # NEW CODE: add dependencies for splunk-otel-dotnet-install.sh
 RUN apt-get update && \
-	apt-get install -y unzip
+ apt-get install -y unzip
 
 # NEW CODE: download Splunk OTel .NET installer
 RUN curl -sSfL https://github.com/signalfx/splunk-otel-dotnet/releases/latest/download/splunk-otel-dotnet-install.sh -O
@@ -113,7 +112,7 @@ RUN dotnet build "./helloworld.csproj" -c $BUILD_CONFIGURATION -o /app/build
 
 # NEW CODE: add dependencies for splunk-otel-dotnet-install.sh
 RUN apt-get update && \
-	apt-get install -y unzip
+ apt-get install -y unzip
 
 # NEW CODE: download Splunk OTel .NET installer
 RUN curl -sSfL https://github.com/signalfx/splunk-otel-dotnet/releases/latest/download/splunk-otel-dotnet-install.sh -O
@@ -168,9 +167,7 @@ exec "$@"
 
 > vi での変更を保存するには、`esc`キーを押してコマンドモードに入り、`:wq!`と入力してから`enter/return`キーを押します。
 
-`entrypoint.sh`スクリプトは、instrumentation に含まれる instrument.sh スクリプトから環境変数を
-ソースするために必要です。これにより、各プラットフォームに対して環境変数が正しく
-設定されることが保証されます。
+`entrypoint.sh`スクリプトは、計装に含まれる instrument.sh スクリプトが環境変数を**コンテナ起動時に**取得するために必要です。これにより、各プラットフォームに対して環境変数が正しく設定されることが保証されます。
 
 > 「なぜ Linux ホスト上で OpenTelemetry .NET instrumentation を有効化したときのように、
 > Dockerfile に以下のコマンドを含めるだけではだめなのか？」と疑問に思うかもしれません。

content/ja/ninja-workshops/8-docker-k8s-otel/8-deploy-app-k8s.md

@@ -111,7 +111,7 @@ spec:
 ```
 
 > [!tip]- Kubernetes における Deployment とは？
-> deployment.yaml ファイルは、deployment リソースを定義するために使用される kubernetes 設定ファイルです。このファイルは Kubernetes でアプリケーションを管理するための基盤となります！deployment 設定は deployment の**_望ましい状態_**を定義し、Kubernetes が**_実際の_**状態がそれと一致するよう保証します。これにより、アプリケーション pod の自己修復が可能になり、アプリケーションの簡単な更新やロールバックも可能になります。
+> deployment.yaml ファイルは、deployment リソースを定義するために使用される kubernetes 設定ファイルです。このファイルは Kubernetes でアプリケーションを管理するための基盤となります！deployment 設定は deployment の **_望ましい状態_** を定義し、Kubernetes が **_実際の状態_** がそれと一致するよう保証します。これにより、アプリケーション pod の自己修復が可能になり、アプリケーションの簡単な更新やロールバックも可能になります。
 
 次に、同じディレクトリに`service.yaml`という名前の 2 つ目のファイルを作成します：
 
@@ -194,7 +194,7 @@ curl http://10.43.102.103:8080/hello/Kubernetes
 
 ## OpenTelemetry の設定
 
-.NET OpenTelemetry インストゥルメンテーションはすでに Docker イメージに組み込まれています。しかし、データの送信先を指定するためにいくつかの環境変数を設定する必要があります。
+.NET OpenTelemetry 計装はすでに Docker イメージに組み込まれています。しかし、データの送信先を指定するためにいくつかの環境変数を設定する必要があります。
 
 先ほど作成した`deployment.yaml`ファイルに以下を追加します：
 

content/ja/ninja-workshops/8-docker-k8s-otel/9-customize-collector-config.md

@@ -98,18 +98,17 @@ helm チャートをデプロイするために使用される`values.yaml`フ
 
 例を見てみましょう。
 
-## Add Infrastructure Events Monitoring
+## Infrastructure Events Monitoring の追加
 
-For our first example, let's enable infrastructure events monitoring for our K8s cluster.
+最初の例として、K8s クラスターの infrastructure events monitoring を有効にしましょう。
 
-> This will allow us to see Kubernetes events as part of the Events Feed section in charts.
-> The cluster receiver will be configured with a Smart Agent receiver using the kubernetes-events
-> monitor to send custom events. See [Collect Kubernetes events](https://docs.splunk.com/observability/en/gdi/opentelemetry/collector-kubernetes/kubernetes-config-logs.html#collect-kubernetes-events)
-> for further details.
+> これにより、charts の Events Feed セクションの一部として Kubernetes イベントを確認できるようになります。
+> cluster receiver は、kubernetes-events
+> monitor を使用して Smart Agent receiver で設定され、custom イベントを送信します。詳細については[Collect Kubernetes events](https://docs.splunk.com/observability/en/gdi/opentelemetry/collector-kubernetes/kubernetes-config-logs.html#collect-kubernetes-events)を参照してください。
 
-This is done by adding the following line to the `values.yaml` file:
+これは`values.yaml`ファイルに以下の行を追加することで実行されます：
 
-> Hint: steps to open and save in vi are in previous steps.
+> ヒント：vi での開き方と保存方法は前のステップにあります。
 
 ```yaml
 logsEngine: otel
@@ -118,7 +117,7 @@ splunkObservability:
 agent:
 ```
 
-Once the file is saved, we can apply the changes with:
+ファイルが保存されたら、以下のコマンドで変更を適用できます：
 
 {{< tabs >}}
 {{% tab title="Script" %}}
@@ -154,7 +153,7 @@ Splunk OpenTelemetry Collector is installed and configured to send data to Splun
 {{% /tab %}}
 {{< /tabs >}}
 
-We can then view the config map and ensure the changes were applied:
+その後、config map を表示して変更が適用されたことを確認できます：
 
 {{< tabs >}}
 {{% tab title="Script" %}}
@@ -166,7 +165,7 @@ kubectl describe cm splunk-otel-collector-otel-k8s-cluster-receiver
 {{% /tab %}}
 {{% tab title="Example Output" %}}
 
-Ensure `smartagent/kubernetes-events` is included in the agent config now:
+`smartagent/kubernetes-events`が agent config に含まれていることを確認してください：
 
 ```bash
   smartagent/kubernetes-events:
@@ -186,16 +185,16 @@ Ensure `smartagent/kubernetes-events` is included in the agent config now:
 {{% /tab %}}
 {{< /tabs >}}
 
-> Note that we specified the cluster receiver config map since that's
-> where these particular changes get applied.
+> これらの特定の変更が適用されるのは
+> cluster receiver config map なので、そちらを指定していることに注意してください。
 
-## Add the Debug Exporter
+## Debug Exporter の追加
 
-Suppose we want to see the traces and logs that are sent to the collector, so we can
-inspect them before sending them to Splunk. We can use the debug exporter for this purpose, which
-can be helpful for troubleshooting OpenTelemetry-related issues.
+collector に送信される trace と log を確認して、
+Splunk に送信する前に検査したいとします。この目的のために debug exporter を使用できます。これは
+OpenTelemetry 関連の問題のトラブルシューティングに役立ちます。
 
-Let's add the debug exporter to the bottom of the values.yaml file as follows:
+values.yaml ファイルの下部に以下のように debug exporter を追加しましょう：
 
 ```yaml
 logsEngine: otel
@@ -217,7 +216,7 @@ agent:
             - debug
 ```
 
-Once the file is saved, we can apply the changes with:
+ファイルが保存されたら、以下のコマンドで変更を適用できます：
 
 {{< tabs >}}
 {{% tab title="Script" %}}
@@ -253,18 +252,17 @@ Splunk OpenTelemetry Collector is installed and configured to send data to Splun
 {{% /tab %}}
 {{< /tabs >}}
 
-Exercise the application a few times using curl, then tail the agent collector logs with the
-following command:
+curl を使用してアプリケーションを数回実行してから、以下のコマンドで agent collector の log を tail します：
 
 ```bash
 kubectl logs -l component=otel-collector-agent -f
 ```
 
-You should see traces written to the agent collector logs such as the following:
+以下のような trace が agent collector の log に書き込まれているのが確認できるはずです：
 
 ```
-2024-12-20T01:43:52.929Z	info	Traces	{"kind": "exporter", "data_type": "traces", "name": "debug", "resource spans": 1, "spans": 2}
-2024-12-20T01:43:52.929Z	info	ResourceSpans #0
+2024-12-20T01:43:52.929Z info Traces {"kind": "exporter", "data_type": "traces", "name": "debug", "resource spans": 1, "spans": 2}
+2024-12-20T01:43:52.929Z info ResourceSpans #0
 Resource SchemaURL: https://opentelemetry.io/schemas/1.6.1
 Resource attributes:
      -> splunk.distro.version: Str(1.8.0)
@@ -296,11 +294,11 @@ Resource attributes:
      -> k8s.cluster.name: Str(derek-1-cluster)
 ```
 
-And log entries such as:
+そして以下のような log エントリも確認できます：
 
 ```
-2024-12-20T01:43:53.215Z	info	Logs	{"kind": "exporter", "data_type": "logs", "name": "debug", "resource logs": 1, "log records": 2}
-2024-12-20T01:43:53.215Z	info	ResourceLog #0
+2024-12-20T01:43:53.215Z info Logs {"kind": "exporter", "data_type": "logs", "name": "debug", "resource logs": 1, "log records": 2}
+2024-12-20T01:43:53.215Z info ResourceLog #0
 Resource SchemaURL: https://opentelemetry.io/schemas/1.6.1
 Resource attributes:
      -> splunk.distro.version: Str(1.8.0)
@@ -327,7 +325,7 @@ Resource attributes:
      -> k8s.cluster.name: Str(derek-1-cluster)
 ```
 
-If you return to Splunk Observability Cloud though, you'll notice that traces and logs are
-no longer being sent there by the application.
+ただし、Splunk Observability Cloud に戻ると、アプリケーションから trace と log が
+もはやそこに送信されていないことに気づくでしょう。
 
-Why do you think that is? We'll explore it in the next section.
+なぜそうなったと思いますか？次のセクションで詳しく説明します。

content/ja/ninja-workshops/8-docker-k8s-otel/_index.md

@@ -13,7 +13,7 @@ hidden: false
 このワークショップでは、以下の項目について実践経験を積むことができます：
 
 - Linux および Kubernetes 環境で、Splunk ディストリビューションの OpenTelemetry .NET を使用してコレクターのデプロイと.NET アプリケーションの計装を実践します。
-- .NET アプリケーションの「Docker 化」、Docker での実行、そして Splunk OpenTelemetry インストゥルメンテーションの追加を実践します。
+- .NET アプリケーションの「Docker 化」、Docker での実行、そして Splunk OpenTelemetry 計装の追加を実践します。
 - Helm を使用した K8s 環境での Splunk ディストロのコレクターのデプロイを実践します。その後、コレクター設定をカスタマイズし、問題のトラブルシューティングを行います。
 
 {{% notice title="Tip" style="primary"  icon="lightbulb" %}}