Adding translations

Author: guacbot

content/ja/account_management/saml/azure.md

@@ -0,0 +1,90 @@
+---
+title: Azure AD を SAML IdP として構成する方法
+kind: documentation
+aliases:
+ - /ja/account_management/faq/how-do-i-configure-azure-ad-as-a-saml-idp/
+further_reading:
+ - link: account_management/saml
+ tag: Documentation
+ text: Datadog アカウントのための SAML の構成
+ - link: account_management/multi_organization
+ tag: Documentation
+ text: 複数のアカウントを持つチームとオーガニゼーションの構成
+---
+ここでは、Datadog で Azure AD を SAML IdP として構成する手順を説明します。
+**注**: この設定には、Azure AD の Premium サブスクリプションが必要です。
+
+## コンフィグレーション
+
+1. `https://portal.azure.com/` に移動します。
+
+2. Azure にログインしたら、左側のメニューで Azure Active Directory タブに移動します。
+
+3. **エンタープライズアプリケーション**サービスを選択します。
+
+4. **新しいアプリケーション**ボタンをクリックします。
+
+5. **ギャラリー以外のアプリケーション**を選択します。
+
+ {{< img src="account_management/saml/non_gallery_application.png" alt="ギャラリー以外のアプリケーション" style="width:20%;">}}
+
+6. アプリケーションに名前を付けます (例: **DatadogSSO_test**)。
+
+7. **追加**をクリックします。
+
+8. アプリケーションが正しく追加されたら、**シングルサインオンを構成する (必須)**に移動します。
+
+9. シングルサインオンのモードとして **SAML ベースのサインオン**を選択します。
+
+ {{< img src="account_management/saml/saml_based_sign_on.png" alt="SAML ベースのサインオン" style="width:70%;">}}
+
+10. [Datadog の SAML ページ][1]に移動し、ページの右側で、**Service Provider Entity ID** と **Assertion Consumer Service** の URL を見つけます。これらの URL の値をコピーして、**識別子**と**応答 URL** のテキストフォームにそれぞれ貼り付けます。
+ Datadog で以下をコピーします。
+
+ {{< img src="account_management/saml/Step10Redo.png" alt="Step10Redo" style="width:70%;">}}
+
+ Azure ポータルで貼り付けます。
+
+ {{< img src="account_management/saml/set_values_azure.png" alt="Azure の値を設定" style="width:70%;">}}
+
+11. **ユーザー識別子**の値として、`user.mail` を設定します。
+
+ {{< img src="account_management/saml/user_identifier.png" alt="ユーザーの識別子" style="width:70%;">}}
+
+12. ページ下部の**通知用電子メール**に入力します。アクティブな署名証明書の有効期限が近づくと、証明書の更新手順が記載された通知が、この電子メールアドレスに送信されます。
+
+ {{< img src="account_management/saml/notification_email.png" alt="通知メール" style="width:70%;">}}
+
+13. 手順 5 のページの下部にある **DatadogSSO_test の構成**をクリックします。
+
+14. DatadogSSO_test の構成の手順 3 まで下へスクロールして、シングルサインオンセクションを見つけ、**SAML XML メタデータ**ファイルをダウンロードします。
+
+15. **SSO 構成セクション**のトップに移動し、**保存**をクリックします。
+
+16. [Datadog の SAML ページ][1]に戻り、手順 14 でダウンロードした **SAML XML メタデータ**ファイルをアップロードします。
+
+ {{< img src="account_management/saml/SAML_Configuration___Datadog10.png" alt="SAML_Configuration___Datadog10" style="width:70%;">}}
+
+17. アップロードする XML ファイルを選択してから、必ず **Upload File** ボタンを押してください。
+
+18. これで完了です。SAML is ready と表示され、有効な IdP メタデータがインストールされていることが示されます。
+
+ {{< img src="account_management/saml/SAML_Configuration___Datadog11.png" alt="SAML_Configuration___Datadog11" style="width:70%;">}}
+
+19. **Enable** を押すと、Azure AD から Datadog にログインできるようになります。
+
+ {{< img src="account_management/saml/SAML_Configuration___Datadog12.png" alt="SAML_Configuration___Datadog12" style="width:70%;">}}
+
+## オプション
+
+Datadog のボタンやリンクから SSO を使用する場合は、サインオン URL を追加する必要があります。それには、Azure アプリケーションの SSO 構成セクション (手順 8) に戻り、**詳細な URL 設定の表示**をチェックします。
+
+次に、[Datadog の SAML ページ][1]に表示されるシングルサインオン URL を貼り付けます。
+
+{{< img src="account_management/saml/SAML_Configuration___Datadog13.png" alt="SAML_Configuration___Datadog13" style="width:60%;">}}
+
+## その他の参考資料
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://app.datadoghq.com/saml/saml_setup

content/ja/agent/docker/log.md

@@ -0,0 +1,297 @@
+---
+title: Docker ログの収集
+kind: documentation
+aliases:
+ - /ja/logs/docker
+ - /ja/logs/languages/docker
+ - /ja/logs/log_collection/docker
+further_reading:
+ - link: logs/explorer
+ tag: Documentation
+ text: ログの調査方法
+ - link: logs/explorer/analytics
+ tag: Documentation
+ text: ログ分析の実行
+ - link: logs/processing
+ tag: Documentation
+ text: ログの処理方法
+ - link: logs/processing/parsing
+ tag: Documentation
+ text: パースの詳細
+---
+## 概要
+
+Datadog Agent 6 以降は、コンテナからログを収集します。2 通りのインストレーション方法があります。
+
+- Agent が Docker 環境の外部にあるホスト
+- コンテナ化された Agent の Docker 環境へのデプロイ
+
+環境コンテナからすべてのログを収集することも、コンテナイメージ名またはコンテナラベルで絞り込んで、収集するログを選別することもできます。
+
+本ドキュメントでは、実行中のすべてのコンテナからログを収集する方法と共に、オートディスカバリーを活用しログインテグレーションを有効にする方法を紹介します。
+
+## セットアップ
+
+### コンテナログのすべてを収集するためのシングルステップインストール
+
+まず最初に、Agent（コンテナバージョンおよび直接ホストバージョンともに） のインストレーションと、すべてのコンテナのログ収集を有効にします。
+
+{{< tabs >}}
+{{% tab "Container Installation" %}}
+
+Datadog Agent を埋め込みホストを監視する [Docker コンテナ][1] を実行するには、次のコマンドを使用します。
+
+```shell
+docker run -d --name datadog-agent \
+ -e DD_API_KEY="<DATADOG_API_キー>" \
+ -e DD_LOGS_ENABLED=true \
+ -e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true \
+ -e DD_AC_EXCLUDE="name:datadog-agent" \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ -v /proc/:/host/proc/:ro \
+ -v /opt/datadog-agent/run:/opt/datadog-agent/run:rw \
+ -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
+ datadog/agent:latest
+```
+
+最新版の Datadog Agent の使用が推奨されます。Docker Hub で利用できる [Agent v6 のイメージ][2]リストを参照してください。
+
+ログ収集に関連するコマンド：
+
+| コマンド | 説明 |
+|-------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `-e DD_LOGS_ENABLED=true` | `true` に設定すると、ログ収集が有効になります。Agent は構成ファイルのログ命令を探します。 |
+| `-e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true` | すべてのコンテナのログ収集を有効にするログコンフィギュレーションを追加します。 |
+| `-v /opt/datadog-agent/run:/opt/datadog-agent/run:rw` | 再起動の際やネットワークで問題が生じた際でもコンテナログを紛失しないよう、このディレクトリ内の各コンテナのために収集された最後のログ行は、ホストに保存されます。 |
+| `-e DD_AC_EXCLUDE="name:datadog-agent"` | Datadog Agent が自身のログやメトリクスを収集したり送信するのを防ぎます。Datadog Agent ログやメトリクスを収集したい場合は、このパラメータを削除します。 |
+| `-v /var/run/docker.sock:/var/run/docker.sock:ro` | ログは Docker ソケットの `stdout/stderr` コンテナから収集されます。 |
+
+[1]: https://github.com/DataDog/datadog-agent/tree/master/Dockerfiles/agent
+[2]: https://hub.docker.com/r/datadog/agent/tags
+{{% /tab %}}
+{{% tab "Host Installation" %}}
+
+ホストに[最新版の Agent 6][1] をインストールします。Agent は [ホスト上のファイル][2] または `stdout`/`stderr` コンテナからログを収集できます。
+
+デフォルトの状態では、Datadog Agent でのログ収集は *無効* になっています。有効にするには、`datadog.yaml` 構成ファイルに次の行を加えます。
+
+```yaml
+logs_enabled: true
+listeners:
+ - name: docker
+config_providers:
+ - name: docker
+ polling: true
+logs_config:
+ container_collect_all: true
+```
+
+[Agent を再起動][3] し、Datadog のコンテナログを確認します。
+
+[1]: /ja/agent/basic_agent_usage
+[2]: /ja/agent/logs/#custom-log-collection
+[3]: /ja/agent/guide/agent-commands/#restart-the-agent
+{{% /tab %}}
+{{< /tabs >}}
+
+**重要**:
+
+* Datadog Agent 6.8 以降では、`source` や `service` の初期値は `short_image` タグの値となります。
+下で説明するように、ソースやサービスの値はオートディスカバリーで上書きすることができます。`source` 値をインテグレーション名に設定すると、ログをパースして関連情報を抽出するインテグレーション Pipelines がインストールされます。
+
+* コンテナ `Stderr` からのログは `Error` の状態がデフォルトとなります。
+
+* Docker のデフォルトである json-file ログドライバーではなく、*journald* ログドライバーを使用する場合は、コンテナ環境の設定に関するドキュメント [journald インテグレーション][1] をご覧ください。
+
+### インテグレーションのためのログ収集を有効にする
+
+Datadog Agent 6.8 以降では、`source` や `service` の初期値は `short_image` タグの値となります。これにより、Datadog は各コンテナのログソースを特定でき、対応するインテグレーションを自動的にインストールできます。
+
+コンテナのショートイメージ名とカスタムイメージのインテグレーション名が一致しない場合があります。アプリケーションにふさわしい名前に上書きするには、[Datadog オートディスカバリー][2] や [Kubernetes ポッドアノテーション][3] またはコンテナラベルを使います。
+
+オートディスカバリーは、ファイルの種類に応じてラベルが以下の形式となることを前提とします。
+
+{{< tabs >}}
+{{% tab "Dockerfile" %}}
+
+Dockerfile に以下の`LABEL` を追加します：
+
+```text
+LABEL "com.datadoghq.ad.logs"='[<ログコンフィギュレーション>]'
+```
+
+{{% /tab %}}
+{{% tab "Docker-Compose" %}}
+
+`docker-compose.yaml` ファイルに以下のラベルを追加します：
+
+```yaml
+labels:
+ com.datadoghq.ad.logs: '["<ログコンフィギュレーション>"]'
+```
+
+{{% /tab %}}
+{{% tab "Run Command" %}}
+
+実行コマンドとして次のラベルを追加します：
+
+```text
+-l com.datadoghq.ad.logs='[<ログコンフィギュレーション>]'
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+`<LOG_CONFIG>` がログ収集コンフィギュレーションの場合、インテグレーション構成ファイルにあります。[詳細は、ログ収集コンフィギュレーションを参照してください。][4]
+
+#### 例
+
+{{< tabs >}}
+{{% tab "NGINX Dockerfile" %}}
+
+次の Dockerfile は対応するコンテナにおける NGINX ログインテグレーションを有効にします (`service` の値は変更できます)：
+
+```text
+LABEL "com.datadoghq.ad.logs"='[{"source": "nginx", "service": "webapp"}]'
+```
+
+メトリクスとログ、両 NGINX インテグレーションを有効にする方法
+
+```text
+LABEL "com.datadoghq.ad.check_names"='["nginx"]'
+LABEL "com.datadoghq.ad.init_configs"='[{}]'
+LABEL "com.datadoghq.ad.instances"='[{"nginx_status_url": "http://%%host%%:%%port%%/nginx_status"}]'
+LABEL "com.datadoghq.ad.logs"='[{"source": "nginx", "service": "webapp"}]'
+```
+
+{{% /tab %}}
+{{% tab "Java multi-line logs" %}}
+
+スタックトレースのような複数行のログのため、Agent には複数の行を 1 行に集約する[複数行の処理規則][1]があります。
+
+ログの一例 (Java スタックトレース):
+
+```text
+2018-01-03T09:24:24.983Z UTC Exception in thread "main" java.lang.NullPointerException
+ at com.example.myproject.Book.getTitle(Book.java:16)
+ at com.example.myproject.Author.getBookTitles(Author.java:25)
+ at com.example.myproject.Bootstrap.main(Bootstrap.java:14)
+```
+
+下にあるように、コンテナで `com.datadoghq.ad.logs` ラベルを使い、上記のログが正確に収集されているかを確かめます。
+
+```yaml
+labels:
+ com.datadoghq.ad.logs: '[{"source": "java", "service": "myapp", "log_processing_rules": [{"type": "multi_line", "name": "log_start_with_date", "pattern" : "\\d{4}-(0?[1-9]|1[012])-(0?[1-9]|[12][0-9]|3[01])"}]}]'
+```
+
+[複数行の処理規則][1]には、他にもさまざまなパターンが記載されています。
+
+[1]: /ja/agent/logs/advanced_log_collection/#multi-line-aggregation
+{{% /tab %}}
+{{% tab "Kubernetes" %}}
+
+Kubernetes を実行している場合、ポッドアノテーションを利用できます。
+
+```yaml
+apiVersion: apps/v1
+kind: ReplicaSet
+metadata:
+ name: nginx
+spec:
+ selector:
+ matchLabels:
+ app: webapp
+ template:
+ metadata:
+ annotations:
+ ad.datadoghq.com/nginx.logs: '[{"source":"nginx","service":"webapp"}]'
+ labels:
+ app: webapp
+ name: nginx
+ spec:
+ containers:
+ - name: nginx
+ image: nginx:latest
+```
+
+オートディスカバリーに関する手順、一例、詳細に関しては、[オートディスカバリーガイド][1]を参照してください。 
+
+[1]: /ja/agent/autodiscovery/integrations/?tab=kubernetespodannotations#configuration
+{{% /tab %}}
+{{< /tabs >}}
+
+**注**: オートディスカバリー機能は、`DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL` 環境変数の有無にかかわらず使用できます。次のオプションの中から 1 つを選択してください。
+
+* コンテナラベルまたはポッドアノテーションを使い、ログを収集するコンテナを選択します。
+* 環境変数を使いすべてのコンテナからログを集め、デフォルトの `source` 値と `service` 値を上書きします。
+* 必要とする一部のコンテナの処理規則を追加します。
+
+### コンテナを絞り込む
+
+以下の方法で、ログ、メトリクス、オートディスカバリーの絞り込みができます。これにより、Datadog Agent ログの収集を防ぐことができます。
+
+{{< tabs >}}
+{{% tab "Environment variable" %}}
+
+イメージまたはコンテナ名で絞り込んだコンテナ一覧を含めたり除く際に使える環境変数が 2 つあります。
+
+* `DD_AC_INCLUDE`: 常に対象に入れるコンテナのホワイトリスト
+* `DD_AC_EXCLUDE`: 除外するコンテナのブラックリスト
+
+このオプションは、スペース区切り文字列形式です。たとえば、2 つのイメージのみをモニターして残りを除外したい場合、以下のようにします。
+
+```text
+DD_AC_EXCLUDE = "image:.*"
+DD_AC_INCLUDE = "image:cp-kafka image:k8szk"
+```
+
+特定のコンテナ名を除外するには、以下のようにします。
+
+```text
+DD_AC_EXCLUDE = "name:datadog-agent"
+```
+
+{{% /tab %}}
+
+{{% tab "Configuration File" %}}
+
+`datadog.yaml` にパラメーターが 2 つあり、イメージまたはコンテナ名で絞り込まれたコンテナ一覧を含めたり除外できます。
+
+* `ac_exclude`: 常に含めるコンテナのホワイトリスト
+* `ac_include`: 除外するコンテナのブラックリスト
+
+たとえば、2 つのイメージのみをモニターして残りを除外したい場合、以下のようにします。
+
+```text
+ac_exclude: ["image:.*"]
+ac_include: ["image:cp-kafka", "image:k8szk"]
+```
+
+Datadog Agent を除外するには、以下のようにします。
+
+```text
+ac_exclude = ["name:datadog-agent"]
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+## 存続期間が短いコンテナ
+
+Docker 環境では、Agent は Docker イベントによりコンテナのアップデートをリアルタイムに受け取ります。Agent は 1 秒ごとにコンテナラベル（オートディスカバリー）からコンフィギュレーションを抽出しアップデートします。
+
+Agent v6.14 以降、Agent はすべてのコンテナ（実行中かは問わず）のログを収集します。つまり、直近の 1 秒間に開始し停止した存続期間の短いコンテナのログは、削除されるまで収集されます。
+
+Kubernetes 環境には、[Kubernetes 存続期間が短いコンテナのドキュメント][5]を参照してください。
+
+## その他の参考資料
+
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /ja/integrations/journald
+[2]: /ja/agent/autodiscovery
+[3]: /ja/agent/autodiscovery/integrations/?tab=kubernetespodannotations#configuration
+[4]: /ja/agent/logs/#custom-log-collection
+[5]: /ja/agent/kubernetes/daemonset_setup/?tab=k8sfile#short-lived-containers