Alibaba Cloud ACK Edge は Simple Log Service と統合されています。ACK Edge クラスターの作成時に Simple Log Service を有効にすることで、クラスターのコンテナログ (標準出力やテキストファイルなど) を迅速に収集できます。
ステップ1:Logtail コンポーネントの有効化
ACK Edge クラスターの作成時に Log Service の使用 を選択することで、Logtail コンポーネントを有効にできます。このコンポーネントは、既存の ACK Edge クラスターでも有効化できます。
クラスター作成時の Logtail の有効化
ACKコンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。
クラスターリスト ページで、Kubernetes クラスターの作成 をクリックします。
以下の手順では、Simple Log Service を有効にする方法のみを説明します。クラスターの作成方法の詳細については、「ACK Edge クラスターの作成」をご参照ください。
コンポーネント設定 ウィザードで、Log Service の使用 を選択します。
Log Service の使用 を選択すると、プロジェクトを作成するように求められます。Simple Log Service がログを整理する方法の詳細については、「プロジェクト」をご参照ください。プロジェクトは、次のいずれかの方法で作成できます。
プロジェクトの選択 をクリックし、既存のプロジェクトを選択して収集されたログを管理します。
プロジェクトの作成 をクリックします。収集されたログを管理するための新しいプロジェクトが自動的に作成されます。プロジェクトには、自動的に
k8s-log-{ClusterID}という名前が付けられます。ここで、{ClusterID} は新しい ACK Edge クラスターの一意の ID です。
設定が完了したら、右下隅にある クラスターの作成 をクリックし、表示されたダイアログボックスで OK をクリックします。
クラスターが作成されると、Logtail が有効になった ACK Edge クラスターが [クラスター] ページに表示されます。
既存クラスターでの Logtail の有効化
ACKコンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。
[クラスター] ページで、管理するクラスターの名前をクリックします。 左側のナビゲーションウィンドウで、 を選択します。
アドオン管理 ページで、[ログとモニタリング] タブをクリックし、logtail-ds コンポーネントを見つけます。
説明ACK Edge 1.18.8-aliyunedge.1 以降のバージョンでは、ログコンポーネントは
logtail-dsに統合されます。ACK Edge バージョン 1.18.8-aliyunedge.1 以前では、ログコンポーネントは
alibaba-log-controllerとlogtail-ds-dockerで構成されています。
logtail-ds コンポーネントの行で、インストール をクリックします。確定 ダイアログボックスで、OK をクリックします。
以前のバージョンの Simple Log Service コンポーネントがインストールされている場合は、コンポーネントの右側にある アップグレード をクリックします。
ステップ2:アプリケーションの Simple Log Service 設定
アプリケーションの作成時に Simple Log Service を設定して、ACK Edge クラスターからログを収集できます。
ACKコンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。
[クラスター] ページで、管理するクラスターの名前をクリックします。 左側のウィンドウで、 を選択します。
デプロイメント ページで、上部の 名前空間 ドロップダウンリストから Namespace を選択し、右上隅にある イメージによる作成 をクリックします。
基本情報 タブで、[名前]、Replicas:、タイプ を設定します。次に 次へ をクリックして、コンテナー ページに移動します。
このセクションでは、Simple Log Service に関連する設定のみを説明します。その他のアプリケーション設定については、「ステートレス Deployment の作成」をご参照ください。
ログの設定 セクションで、ログを設定します。
採集配置 を構成します。
重要ログ収集設定は、作成後に変更することはできません。変更を加えるには、「DaemonSet-CRD を使用したコンテナログの収集」をご参照ください。
採集配置 をクリックします。各収集設定は、ログストア と [コンテナ内のログパス] から構成されます。
[Logstore]:収集したログを保存する Logstore の名前を指定します。指定した Logstore が存在しない場合、ACK はクラスターに関連付けられた Simple Log Service プロジェクト内に自動的に作成します。
説明デフォルトでは、新しく作成された Logstore 内のログは 180 日間保持されます。
[コンテナ内のログパス]:収集するログのパスを指定します。たとえば、Tomcat からテキストログを収集するには、
/usr/local/tomcat/logs/catalina.*.logを使用します。説明stdoutを指定した場合、Logtail はコンテナの標準出力 (stdout) と標準エラー (stderr) を収集します。各収集設定は、対応する Logstore に対して自動的に作成され、デフォルトでシンプルモード (行単位の収集) が使用されます。複数行モードやより高度な収集方法については、「コンソールを使用した DaemonSet モードでのコンテナテキストログの収集」および「コンソールを使用した DaemonSet モードでのコンテナ標準出力の収集」をご参照ください。
続行する前に、ログプラグインがクラスターにデプロイされていることを確認してください。 たとえば、[Logstore] フィールドをそれぞれ
accessとcatalinaに設定できます。カスタマイズTag を構成します。
各カスタマイズTag は、収集されたログに追加されるキーと値のペアです。これらのタグを使用して、バージョン番号などの情報でコンテナのログデータにラベルを付けることができます。
たとえば、[タグ名]には
releaseを、[タグ値]には1.0.0を設定します。
すべての設定が完了したら、右上隅の 次へ をクリックして続行します。
以降の手順については、「ステートレス Deployment の作成」をご参照ください。
ステップ3:ログの表示
Tomcat アプリケーションのログ収集を設定すると、ログは Simple Log Service に保存されます。その後、Simple Log Service コンソールでコンテナログを表示できます。
Simple Log Service コンソールにアクセスします。
プロジェクト一覧 セクションで、お使いの Kubernetes クラスターのプロジェクト (デフォルトでは
k8s-log-{ClusterID}) を選択します。 次に、ログストア タブに移動します。収集設定で指定した Logstore を見つけます。Logstore の行で、
アイコンをクリックし、Query and Analysis を選択します。ログクエリページでは、アプリケーションの標準出力とコンテナ内のテキストログを表示できます。追加したカスタムタグもログフィールドに追加されます。
関連ドキュメント
サイドカーを使用してコンテナテキストログを収集するには、「サイドカーモードでの Kubernetes コンテナテキストログの収集」をご参照ください。
Kubernetes コンテナの標準出力を収集するには、「DaemonSet モード (レガシー) での Kubernetes コンテナの標準出力の収集」をご参照ください。
ログにアラートルールを追加することで、クラスターの実行ステータスを監視できます。詳細については、「アラート監視ルールの管理」をご参照ください。
トラブルシューティング情報については、「Logtail のログ収集失敗のトラブルシューティング」をご参照ください。
Alibaba Cloud アカウント間でコンテナログを収集するには、「Logtail を使用した Alibaba Cloud アカウント間でのコンテナログの収集」をご参照ください。
ログ保持期間の変更やログ収集の無効化など、Simple Log Service の Logstore に関連する問題については、「Logstore 関連の問題のトラブルシューティング」をご参照ください。