Merge pull request #114 from hibira/JapaneseTransration

Japanese Transration

.github/workflows/docs-ci.yaml

@@ -1,8 +1,8 @@
-name: ci 
+name: ci
 on:
   push:
     branches:
-      - master 
+      - master
       - main
 permissions:
   contents: write
@@ -18,5 +18,10 @@ jobs:
         with:
           key: ${{ github.ref }}
           path: .cache
-      - run: pip install mkdocs-material 
-      - run: mkdocs gh-deploy --force
+      - run: pip install mkdocs-material
+      - run: mkdocs build -f mkdocs.yaml
+      - run: mkdocs build -f mkdocs.ja.yaml
+      - uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

README.md

@@ -29,6 +29,11 @@ For more details or assistance setting up, see:
 mkdocs serve
 ```
 
+If you want to Build and run Japanese content
+```
+mkdocs serve -f mkdocs.ja.yaml
+```
+
 ## Security
 
 See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.

docs/ja/contributors.md

@@ -0,0 +1,22 @@
+# コントリビューター
+
+このサイトのコンテンツは、ソリューションアーキテクト、AWS Observability サービスチームのメンバー、および組織全体のボランティアによってメンテナンスされています。目標は、オブザーバビリティ領域の AWS サービスとオープンソースプロジェクトを設定および使用するための関連するベストプラクティスの発見を改善することです。
+
+これまでのレシピとコンテンツへの貢献は、概ね次の人々からのものです: 
+
+| 著者 | 著者 | 著者 | 著者 |
+| ----------- | ------------------------------------ |--------------------|---------|
+| Alolita Sharma | Aly Shah Imtiaz|Helen Ashton | Elamaran Shanmugam |
+ Dinesh Boddula | Imaya Kumar Jagannathan| Dieter Adant| Eric Hsueh |  
+ Jason Derrett|Kevin Lewin|Mahesh Biradar|Michael Hausenblas|
+ Munish Dabra|Rich McDonough|Rob Sable|Rodrigue Koffi|
+ Sheetal Joshi|Tomasz Wrzonski|Tyler Lynch|Vijayan Sarathy| 
+ Vikram Venkataraman|Yiming Peng|Arun Chandapillai| Alex Livingstone|
+ Kiran Prakash| Bobby Hallahan| Toshal Dudhwala| Franklin Aguinaldo|
+ Nirmal Mehta| Lucas Vieira Souza da Silva| William Armiros| Abhi Khanna|
+ Arvind Raghunathan| Doyita Mitra | Rahul Popat|
+
+
+このサイトで公開されているすべてのレシピは、[MIT-0][mit0] ライセンスを介して利用できます。これは、帰属の要件を削除した通常の MIT ライセンスの変更版です。
+
+[mit0]: https://github.com/aws/mit-0

docs/ja/faq/adot.md

@@ -0,0 +1,34 @@
+# AWS Distro for OpenTelemetry(ADOT) - FAQ
+
+1. **AMP へのメトリクスの取り込みに ADOT コレクタを使用できますか?**
+    はい、2022年5月のメトリクスサポートの本番リリースでこの機能が導入されました。EC2 から、EKS アドオンを介して、ECS サイドカー統合を介して、および/または Lambda レイヤーを介して ADOT コレクタを使用できます。
+
+1. **ADOT コレクタを使用してログを収集し、Amazon CloudWatch または Amazon OpenSearch に取り込むことができますか?**
+    まだできませんが、OpenTelemetry でログを上流で安定化させる作業を行っています。時期が来たら、おそらく 2023 年後半または 2024 年初頭に、ADOT でログをサポートする予定です。詳細は [パブリックロードマップのエントリ](https://github.com/aws-observability/aws-otel-community/issues/11) を参照してください。
+
+1. **ADOT コレクタのリソース使用量とパフォーマンスの詳細はどこで確認できますか?**
+    コレクタのリリースごとに更新している [パフォーマンスレポート](https://aws-observability.github.io/aws-otel-collector/benchmark/report) がオンラインで公開されています。
+
+1. **ADOT を Apache Kafka で使用することは可能ですか?**
+    はい、Kafka エクスポータとレシーバのサポートが ADOT コレクタ v0.28.0 で追加されました。詳細は、[ADOT コレクタのドキュメント](https://aws-otel.github.io/docs/components/kafka-receiver-exporter) をご確認ください。
+
+1. **ADOT コレクタの設定方法を教えてください。**
+    ADOT コレクタは、ローカルに保存されている YAML 設定ファイルを使用して構成されます。 加えて、S3 バケットなどの他の場所に保存されている設定を使用することもできます。 ADOT コレクタを構成するためにサポートされているすべてのメカニズムは、[ADOT コレクタのドキュメント](https://aws-otel.github.io/docs/components/confmap-providers) で詳しく説明されています。
+
+1. **ADOT コレクタで高度なサンプリングを行うことができますか?**
+    現在実装中です。 進捗を確認したい場合は、パブリック [ロードマップ](https://github.com/aws-observability/aws-otel-collector/issues/1135) にサブスクライブしてください。
+
+1. **ADOT コレクタのスケーリングのヒントを教えてください。**
+    はい! アップストリームの OpenTelemetry ドキュメントの [コレクタのスケーリング](https://opentelemetry.io/docs/collector/scaling/) をご覧ください。
+
+1. **ADOT コレクタのフリートを持っています。どのように管理できますか?**
+    これは現在積極的に開発が進められている領域で、2023年に成熟することが期待されています。 詳細については、アップストリームの OpenTelemetry ドキュメントの [管理](https://opentelemetry.io/docs/collector/management/) を参照してください。特に [Open Agent Management Protocol (OpAMP)](https://opentelemetry.io/docs/collector/management/#opamp) をご覧ください。
+
+1. **ADOT コレクタの正常性とパフォーマンスをどのように監視しますか?**
+    1. [コレクタの監視](https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/monitoring.md) - ポート 8080 で公開されているデフォルトのメトリクスを Prometheus レシーバがスクレイプできます
+    2. [Node Exporter](https://prometheus.io/docs/guides/node-exporter/) を使用する - node exporter を実行すると、コレクタが実行されているノード、ポッド、オペレーティング システムに関するいくつかのパフォーマンスと正常性メトリクスも提供されます。
+    3. [Kube-state-metrics (KSM)](https://github.com/kubernetes/kube-state-metrics) - KSM もコレクタに関する興味深いイベントを生成できます。 
+    4. Prometheus の [`up` メトリクス](https://github.com/open-telemetry/opentelemetry-collector/pull/2918)
+    5. はじめに使用できるシンプルな Grafana ダッシュボード: [https://grafana.com/grafana/dashboards/12553]()
+
+1. **製品 FAQ** - [https://aws.amazon.com/otel/faqs/]()

docs/ja/faq/amg.md

@@ -0,0 +1,58 @@
+# Amazon Managed Grafana - よくある質問
+
+**Amazon Managed Grafana を選ぶ理由は何ですか?**
+
+**[高可用性](https://docs.aws.amazon.com/grafana/latest/userguide/disaster-recovery-resiliency.html)**: Amazon Managed Grafana のワークスペースは、マルチ AZ レプリケーションによって高可用性が実現しています。Amazon Managed Grafana はワークスペースの正常性も継続的に監視し、ワークスペースへのアクセスに影響を与えることなく、不健全なノードを置き換えます。Amazon Managed Grafana は、管理とメンテナンスに必要なインフラストラクチャリソースを管理するため、お客様はコンピューティングおよびデータベースノードの可用性を管理する必要がありません。
+
+**[データセキュリティ](https://docs.aws.amazon.com/grafana/latest/userguide/security.html)**: Amazon Managed Grafana は、特別な構成、サードパーティツール、追加コストなしに、保存データの暗号化を行います。[転送中のデータ](https://docs.aws.amazon.com/grafana/latest/userguide/infrastructure-security.html)も TLS によって暗号化されます。
+
+**どの AWS リージョンがサポートされていますか?**
+
+サポートされているリージョンの最新のリストは、[ドキュメントのサポートされているリージョンのセクション](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html#AMG-supported-Regions)でご確認いただけます。
+
+**組織には複数の AWS アカウントとリージョンがあります。Amazon Managed Grafana はこれらのシナリオに対応していますか**
+
+Amazon Managed Grafana は [AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html) と統合されており、組織単位 (OU) の AWS アカウントとリソースを検出できます。AWS Organizations を使用することで、お客様は[複数の AWS アカウントにわたってデータソースの構成とアクセス許可の設定を集中管理](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-and-Organizations.html)できます。
+
+**Amazon Managed Grafana でサポートされているデータソースは何ですか?**
+
+データソースは、Amazon Managed Grafana でダッシュボードを構築するために Grafana でクエリできるストレージバックエンドです。Amazon Managed Grafana は、Amazon CloudWatch、Amazon OpenSearch Service、AWS IoT SiteWise、AWS IoT TwinMaker、Amazon Managed Service for Prometheus、Amazon Timestream、Amazon Athena、Amazon Redshift、AWS X-Ray など、AWS ネイティブサービスを含む[30を超える組み込みデータソース](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-data-sources-builtin.html)をサポートしています。 。さらに、アップグレードされた Grafana Enterprise のワークスペースでは、[約 15 のその他のデータソース](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-data-sources-enterprise.html)も使用できます。
+
+**ワークロードのデータソースはプライベート VPC 内にあります。これらを Amazon Managed Grafana に安全に接続するにはどうすればよいですか?**
+
+VPC 内のプライベートな[データソース](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-vpc.html)は、AWS PrivateLink を介して Amazon Managed Grafana に接続でき、トラフィックは安全に保たれます。さらに、[VPC エンドポイント](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-nac.html)から Amazon Managed Grafana サービスへのアクセス制御は、[IAM リソースポリシー](https://docs.aws.amazon.com/grafana/latest/userguide/VPC-endpoints.html#controlling-vpc)を添付することで制限できます。 
+
+**Amazon Managed Grafana で利用できるユーザー認証メカニズムは何ですか?**
+
+Amazon Managed Grafana ワークスペースでは、[ユーザーは Grafana コンソールに](https://docs.aws.amazon.com/grafana/latest/userguide/authentication-in-AMG.html) 、Security Assertion Markup Language 2.0 (SAML 2.0) または AWS IAM Identity Center (AWS Single Sign-On の後継) をサポートする ID プロバイダを使用したシングルサインオンによって認証されます。
+
+> 関連ブログ: [Grafana Teams を使用した Amazon Managed Grafana でのきめ細かいアクセス制御](https://aws.amazon.com/blogs/mt/fine-grained-access-control-in-amazon-managed-grafana-using-grafana-teams/)
+
+**Amazon Managed Grafana で利用できる自動化のサポートは何ですか?**
+
+Amazon Managed Grafana は [AWS CloudFormation](https://docs.aws.amazon.com/grafana/latest/userguide/creating-resources-with-cloudformation.html) と統合されているため、お客様は AWS リソースのモデリングと設定を行うことができ、AWS でのリソースとインフラストラクチャの作成と管理に費やす時間を短縮できます。 [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) を使用することで、お客様はテンプレートを再利用して、Amazon Managed Grafana リソースを一貫して反復的に設定できます。Amazon Managed Grafana には [API](https://docs.aws.amazon.com/grafana/latest/APIReference/Welcome.html) も用意されており、[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) を介して自動化したり、ソフトウェア/製品と統合したりすることをサポートしています。Amazon Managed Grafana ワークスペースには、自動化と統合のサポートのための [HTTP API](https://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html) があります。
+
+> 関連ブログ: [Amazon Managed Grafana のプライベート VPC データソース サポートの発表](https://aws.amazon.com/blogs/mt/announcing-private-vpc-data-source-support-for-amazon-managed-grafana/)
+
+**組織では Terraform を自動化に使用しています。Amazon Managed Grafana は Terraform をサポートしていますか?**
+はい、[Amazon Managed Grafana は](/observability-best-practices/ja/recipes/recipes/amg-automation-tf/) Terraform による[自動化](https://registry.terraform.io/modules/terraform-aws-modules/managed-service-grafana/aws/latest)をサポートしています
+
+> 例: [Terraform サポートのリファレンス実装](https://github.com/aws-observability/terraform-aws-observability-accelerator/tree/main/examples/managed-grafana-workspace)
+
+**現在の Grafana セットアップで一般的に使用されているダッシュボードがあります。Amazon Managed Grafana で再作成するのではなく、それらを使用する方法はありますか?**
+
+Amazon Managed Grafana は、ダッシュボード、ユーザーなどのデプロイと管理を簡単に自動化できる [HTTP API](https://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html) をサポートしています。 これらの API を GitOps/CI/CD プロセスで使用して、これらのリソースの管理を自動化できます。
+
+**Amazon Managed Grafana はアラートをサポートしていますか?**
+
+[Amazon Managed Grafana アラート](https://docs.aws.amazon.com/grafana/latest/userguide/alerts-overview.html) は、システムの問題をリアルタイムで学習できるようにし、サービスへの混乱を最小限に抑えることができる、効果的で実行可能なアラートを提供します。 Grafana には、アラート情報を 1 か所で検索可能なビューに集約する、アップデートされたアラートシステムである Grafana アラートへのアクセスが含まれています。
+
+**組織では監査のためにすべてのアクションを記録する必要があります。Amazon Managed Grafana のイベントを記録できますか?**
+
+Amazon Managed Grafana は、[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html) と統合されており、Amazon Managed Grafana でのユーザー、ロール、AWS サービスによるアクションの記録を提供します。CloudTrail は、[Amazon Managed Grafana のすべての API 呼び出し](https://docs.aws.amazon.com/grafana/latest/userguide/logging-using-cloudtrail.html)をイベントとしてキャプチャします。キャプチャされる呼び出しには、Amazon Managed Grafana コンソールからの呼び出しと、Amazon Managed Grafana API 操作へのコード呼び出しが含まれます。
+
+**その他どのような情報が入手できますか?**
+
+Amazon Managed Grafana の詳細については、AWS の[ドキュメント](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html)をお読みいただくか、[Amazon Managed Grafana](https://catalog.workshops.aws/observability/en-US/aws-managed-oss/amg) に関する AWS Observability ワークショップを確認するか、[機能](https://aws.amazon.com/grafana/features/?nc=sn&loc=2)、[価格](https://aws.amazon.com/grafana/pricing/?nc=sn&loc=3)の詳細、最新の[ブログ記事](https://aws.amazon.com/grafana/resources/?nc=sn&loc=4&msg-blogs.sort-by=item.additionalFields.createdDate&msg-blogs.sort-order=desc#Latest_blog_posts)、[動画](https://aws.amazon.com/grafana/resources/?nc=sn&loc=4&msg-blogs.sort-by=item.additionalFields.createdDate&msg-blogs.sort-order=desc#Videos)を[製品ページ](https://aws.amazon.com/grafana/)でご確認ください。
+
+**製品 FAQ** [https://aws.amazon.com/grafana/faqs/](https://aws.amazon.com/grafana/faqs/)