From 08d96117b75e4791e3ef5e6b6711cf87d2667bbc Mon Sep 17 00:00:00 2001 From: Yuta Azumi Date: Sat, 7 Nov 2020 21:20:18 +0900 Subject: [PATCH] fix --- README.japanese.md | 2 +- sections/production/smartlogging.japanese.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.japanese.md b/README.japanese.md index 0cf53a1a..fd2d09ae 100644 --- a/README.japanese.md +++ b/README.japanese.md @@ -567,7 +567,7 @@ null == undefined; // true ## ![✔] 5.2. スマートロギングで透明性を高める -**TL;DR:** ログは、デバッグ ステートメントの間抜けな倉庫にも、アプリのストーリーを伝える美しいダッシュボードのイネーブラーにもなり得ます。1日目からロギングプラットフォームを計画する：ログをどのように収集、保存、分析するかで、必要な情報（エラー率、サービスやサーバーを介したトランザクション全体の追跡など）を実際に抽出できるようにします。 +**TL;DR:** ログは、デバッグ ステートメント用のゴミ倉庫にも、アプリのストーリーを伝える美しいダッシュボードのイネーブラーにもなり得ます。1日目からロギングプラットフォームを計画しましょう：ログをどのように収集、保存、分析するかで、必要な情報（エラー率、サービスやサーバーを介したトランザクション全体の追跡など）を実際に抽出できるようにします。 **さもないと** 推論するのが難しいブラックボックスになってしまい、追加情報を追加するためにすべてのロギングステートメントを書き直します。 diff --git a/sections/production/smartlogging.japanese.md b/sections/production/smartlogging.japanese.md index a6e26bfd..f86da6ad 100644 --- a/sections/production/smartlogging.japanese.md +++ b/sections/production/smartlogging.japanese.md @@ -4,9 +4,9 @@ ### 一段落説明 -どちらにしろログステートメントを出力しているのだから、エラーやコアメトリクスをトレースできるような本番情報をラップアップするインターフェイスが必要なのは明らかです (例えば、毎時何個のエラーが発生しているか、最も遅いAPIエンドポイントはどれかなど)。すべてのボックスをチェックする堅牢なロギングフレームワークに適度な努力を投資してはどうでしょうか？これを実現するためには、3つのステップについて熟考した上での決断が必要です。 +どちらにしろログステートメントを出力しているのだから、エラーやコアメトリクスをトレースできるような本番環境の情報をラップアップするインターフェイスが必要なのは明らかです (例えば、毎時何個のエラーが発生しているか、最も遅いAPIエンドポイントはどれかなど)。すべてのボックスをチェックする堅牢なロギングフレームワークに適度な努力を投資してはどうでしょうか？これを実現するためには、3つのステップについて熟考した上での決断が必要です。 -**1. スマートロギング** – 最低限、[Winston](https://github.com/winstonjs/winston)、[Bunyan](https://github.com/trentm/node-bunyan) のような評判の良いロギングライブラリを使用し、各トランザクションの開始と終了時に意味のある情報を書く必要があります。また、ログステートメントをJSONとしてフォーマットし、すべてのコンテキストプロパティ（ユーザーID、操作タイプなど）を提供して、操作チームがそれらのフィールドを操作できるようにすることを検討してください。また、各ログ行に一意のトランザクションIDを含めてください。詳細については、以下の「トランザクションIDをログに書き込む」を参照してください。最後に考慮すべき点として、Elastic Beat のようにメモリや CPU のようなシステムリソースをログに記録するエージェントも含まれています。 +**1. スマートロギング** – 最低限、[Winston](https://github.com/winstonjs/winston)、[Bunyan](https://github.com/trentm/node-bunyan) のような評判の良いロギングライブラリを使用し、各トランザクションの開始と終了時に意味のある情報を書く必要があります。また、ログステートメントを JSON としてフォーマットし、すべてのコンテキストプロパティ（ユーザーID、操作タイプなど）を提供して、運用チームがそれらのフィールドを操作できるようにすることを検討してください。また、各ログ行に一意のトランザクションIDを含めてください。詳細については、以下の「トランザクションIDをログに書き込む」を参照してください。最後に考慮すべき点として、Elastic Beat のようにメモリや CPU のようなシステムリソースをログに記録するエージェントも含まれています。 **2. スマートアグリゲーション** – サーバーのファイルシステムに関する包括的な情報を入手したら、定期的にこれらのデータを集約し、容易にし、可視化するシステムにプッシュしてください。 例えば、Elastic stack は、データを集約して可視化するためのすべてのコンポーネントを提供する、人気のある無料の選択肢です。多くの商用製品が同様の機能を提供していますが、それらはセットアップ時間を大幅に削減し、ホスティングを必要としません。 @@ -14,13 +14,13 @@

-### 可視化の例: Kibana (Elastic スタックの一部) はログコンテンツの高度な検索を容易にします。 +### 可視化の例: Kibana (Elastic Stack の一部) はログコンテンツの高度な検索を容易にします ![Kibana はログコンテンツの高度な検索を容易にします](/assets/images/smartlogging1.png "Kibana はログコンテンツの高度な検索を容易にします。")

-### 可視化の例: Kibana (Elastic スタックの一部) はログに基づいてデータを可視化します。 +### 可視化の例: Kibana (Elastic Stack の一部) はログに基づいてデータを可視化します ![Kibana はログを元にデータを可視化する](/assets/images/smartlogging2.jpg "Kibana はログを元にデータを可視化する") @@ -32,7 +32,7 @@ > いくつかの（ロガーのための）要件を確認してみましょう: > 1. 各ログ行にタイムスタンプを付けます。これは非常にわかりやすいものです - 各ログエントリがいつ発生したかがわかるはずです。 -> 2. ロギングのフォーマットは、機械だけでなく人間にも消化しやすいものでなければなりません。 +> 2. ロギングのフォーマットは、機械だけでなく人間にも分かりやすいものでなければなりません。 > 3. 複数の設定可能な送信先ストリームを許可します。例えば、トレースログを一つのファイルに書き込んでいるが、エラーが発生したときに同じファイルに書き込んで、次にエラーファイルに書き込んで、同時に電子メールを送信する...といった具合です。