Logtail を使用して標準コンテナまたは Kubernetes コンテナからログを収集する際に問題が発生した場合、このトピックを参照して、問題のトラブルシューティングや実行ステータスの確認、その他のメンテナンス操作を行ってください。
マシングループのハートビートの確認
ACK または ACS クラスターにログプラグイン (LoongCollector または Logtail-ds) をインストールした後、Simple Log Service コンソールの マシングループ リストにマシングループが 0 個と表示される場合、または Logtail 設定の作成時にソースマシングループを選択できない場合は、次の順序でマシングループのハートビートを確認してください。マシングループは、Alibaba Cloud アカウント ID などの UID をカスタム ID として使用します。マシングループ内の各サーバーは、IP アドレスを Simple Log Service バックエンドに報告します。
プロジェクトの確認:マシングループは、それが属するプロジェクト内でのみ表示され、プロジェクト間でのアクセスはできません。ACK または ACS クラスター用に自動的に作成されるプロジェクトは、通常
k8s-log-${cluster_id}の形式で命名されます。このプロジェクトを開いていることを確認し、同じプロジェクト内でマシングループを探してください。コンポーネントのインストールステータスの確認:ACK コンソールのクラスター詳細ページで、[コンポーネント管理] を選択し、LoongCollector または Logtail-ds コンポーネントがインストールされ、実行中であることを確認してください。インストールに失敗した場合は、プロンプトに従ってコンポーネントを再インストールしてください。
権限の確認と手動検証: 現在のアカウントに、このプロジェクトのマシン グループを表示する権限があることを確認してください。 Simple Log Service コンソール > リソース > マシングループ に移動し、
k8s-group-${cluster_id}という名前のマシン グループが存在するかどうかを確認します。 マシン グループ設定では、カスタム ID を使用してクラスターを識別します。 マシン グループのカスタム ID が Logtail 収集設定の ID と一致することを確認してください。 マシン グループが存在しない場合は、ACK クラスターにログ コンポーネントを再インストールしてください。
マシングループのハートビートをチェックして、Logtail がコンテナに正しくインストールされていることを確認してください。
マシングループのハートビートステータスを確認してください。
Log Serviceコンソールにログインします。
[プロジェクト] セクションで、管理するプロジェクトをクリックします。
左側のナビゲーションペインで、 を選択します。
マシングループのリストで、対象のマシングループを探し、「操作」列の[ステータスを確認]をクリックします。
[マシングループステータスの表示] ダイアログボックスで、ハートビートステータスを表示し、ハートビートステータスが [OK] のノード数を確認します。
コンテナクラスター内のワーカーノードの数を確認してください。
次のコマンドを実行して、クラスター内のワーカーノードの数を表示します。
kubectl get node | grep -v master出力例:
NAME STATUS ROLES AGE VERSION cn-hangzhou.i-bp17enxc2us3624wexh2 Ready <none> 238d v1.10.4 cn-hangzhou.i-bp1ad2b02jtqd1shi2ut Ready <none> 220d v1.10.4
ハートビートステータスが [OK] のノード数と、コンテナクラスター内のワーカーノードの数を比較します。結果に基づいて問題をトラブルシューティングします。
マシングループ内のすべてのノードのハートビートステータスが [失敗] です。
標準 Docker コンテナからログを収集する場合は、「Docker コンテナからのログ収集 (標準出力とファイル)」を参照して、
${your_region_name}、${your_aliyun_user_id}、${your_machine_group_user_defined_id}パラメーターが正しいことを確認してください。自己管理 Kubernetes クラスターを使用している場合は、「サイドカーを使用して Kubernetes コンテナからテキストログを収集する」を参照して、
{regionId}、{aliuid}、{access-key-id}、{access-key-secret}パラメーターが正しいことを確認してください。パラメーターが正しくない場合は、
helm del --purge alibaba-log-controllerコマンドを実行してインストールパッケージを削除し、再インストールします。
ハートビートステータスが OK のノード数がクラスター内のワーカーノード数より少ない。
YAML ファイルを使用して DaemonSet が手動でデプロイされたかどうかを確認してください。
次のコマンドを実行します。結果が返された場合、YAML ファイルを使用して DaemonSet が手動でデプロイされたことを意味します。
kubectl get po -n kube-system -l k8s-app=logtail${your_region_name}、${your_aliyun_user_id}、${your_machine_group_name} などのパラメーターを実際の値に設定してください。
次のコマンドを実行して、更新されたファイルを適用してください。
kubectl apply -f ./logtail-daemonset.yaml
ACK クラスターで既存のセキュリティグループを再利用した後のハートビートの問題
ACK クラスターが既存のセキュリティグループを使用する場合、LoongCollector または Logtail がマシングループのハートビートを報告できないことがあります。これは、ECS セキュリティグループが Pod CIDR からのインバウンドトラフィックを許可していない場合に発生します。その結果、LoongCollector は CoreDNS にアクセスして SLS エンドポイントを解決できません。
この問題を解決するには、次の手順を実行します。
ECS コンソールにログインし、ACK クラスターで使用されているセキュリティグループを特定してください。
Pod CIDR からのすべてのプロトコルとポートを許可する [インバウンドルール] を追加してください。たとえば、クラスターの Pod CIDR が
10.229.0.0/16の場合は、その値を使用します。Pod が CoreDNS にアクセスし、SLS エンドポイントを解決できることを確認してください。
kube-system名前空間でloongcollector-dsDaemonSet を再起動してください。kubectl rollout restart daemonset/loongcollector-ds -n kube-systemマシングループ のハートビートを再度確認し、ログ収集が再開することを確認します。
FAQ:Docker/LoongCollector をデプロイした後にハートビートがないのはなぜですか?
Docker のデプロイ後、LoongCollector または Logtail がハートビートを示さない、またはマシングループへの登録に失敗する場合、根本的な原因は通常、ユーザー識別子 (AliUID) の設定が欠落していることです。
解決策:
ホストマシンで、
/etc/ilogtail/users/ディレクトリを作成してください。mkdir -p /etc/ilogtail/users//etc/ilogtail/users/ディレクトリに、Alibaba Cloud アカウント ID の名前で空のファイルを作成してください。touch /etc/ilogtail/users/<your-alibaba-cloud-account-id>LoongCollector または Logtail コンテナを起動する際に、次のフラグを追加してディレクトリを読み取り専用としてマウントしてください。
-v /etc/ilogtail/users:/etc/ilogtail/users:roLoongCollector または Logtail コンテナを再起動してください。
検証: SLS コンソールにログオンし、リソース > マシングループ の順に移動して、対象のマシングループを見つけます。[操作] 列で [ステータスの確認] をクリックします。[マシングループステータスの表示] ダイアログボックスで、マシングループのハートビートステータスが OK に変更されたことを確認します。
FAQ:複数の Docker Swarm サーバーが同じ IP を報告しているのに、マシングループにサーバーが 1 つしか表示されないのはなぜですか?
原因: Docker Swarm クラスターでは、複数のサーバーがコンテナネットワークを介して同じ内部 IP アドレスを報告する場合があります。これらのサーバーが同じ ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数の値も共有している場合、システムはそれらを識別できず、マシングループ には 1 つのエントリしか表示されません。
解決策 1:各サーバーの Logtail コンテナに一意の ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数を設定します。
各サーバーに異なる値を設定し、その値が対応する マシングループ 設定と一致することを確認します。例:
-e ALIYUN_LOGTAIL_USER_DEFINED_ID=<unique-id-for-this-server>解決策 2:ALIYUN_LOGTAIL_WORKING_IP 環境変数を設定して、各サーバーに一意の IP アドレスを手動で指定します。
ホストのパブリック IP アドレスや、すべてのサーバーで一意の内部ネットワーク IP アドレスなど、各ホストを一意に識別する値を使用します。
-e ALIYUN_LOGTAIL_WORKING_IP=<unique-ip-for-this-server>コンテナのログ収集のトラブルシューティング
Simple Log Service コンソールのプレビュー ページまたは Logstore クエリページでログが見つからない場合、Simple Log Service がコンテナログを収集していない可能性があります。コンテナのステータスを確認してから、以下の点を確認してください。
マシングループのハートビートに問題がないか確認してください。詳細については、「マシングループのハートビートの確認」をご参照ください。
Logtail 設定が正しいか確認してください。
Logtail 設定で、IncludeLabel ([ラベルホワイトリスト])、ExcludeLabel ([ラベルブラックリスト])、IncludeEnv ([環境変数ホワイトリスト])、および ExcludeEnv ([環境変数ブラックリスト]) の設定が、ログ収集の要件を満たしているか確認してください。
説明ここで指定するラベルは、Kubernetes のラベルではなく、
docker inspectの出力から得られるコンテナのラベルです。IncludeLabel ([ラベルホワイトリスト])、ExcludeLabel ([ラベルブラックリスト])、IncludeEnv ([環境変数ホワイトリスト])、およびExcludeEnv ([環境変数ブラックリスト]) の設定を一時的に削除して、ログを収集できるかどうかを確認できます。 ログが収集された場合、パラメーター設定が正しくありません。
説明自己管理の Docker ノード (Kubernetes 以外) でレガシーな Logtail 設定を使用している場合は、次の点に注意してください。
_container_name_フィールドは、複数の値に対する正規表現マッチングをサポートしていません。単一の正規表現を使用して、複数の特定のコンテナ名をフィルタリングすることはできません。複数の特定のコンテナ(たとえば、
aやbという名前のコンテナ)からログを収集する必要がある場合は、2 つの個別の Logtail 設定を作成し、それぞれに独自の許可リストを設定して、両方を同じ マシングループ にバインドします。単一の Logtail 設定内で重複したラベル名は認識されません。同じラベル名に対して異なる値をマッチングさせる必要がある場合は、正規表現を使用するか、複数の独立した Logtail 設定を作成してください。
説明Simple Log Service コンソールのプレビューまたはクエリページに表示される
_image_nameや_container_name_などのフィールドは、コンテナメタデータプレビューフィールドであり、コンテナラベルではありません。 これらを IncludeLabel (ホワイトリスト) または ExcludeLabel (ブラックリスト) のフィルター値として直接使用することはできません。 フィルター値は正規表現マッチングをサポートしています。 コンテナラベルに基づいてフィルターをかけるには、コンテナが実行されているノードで次のコマンドを実行し、実際のコンテナラベルを取得します。docker inspect <container_id> --format='{{json .Config.Labels}}'出力例:
{"com.docker.compose.service":"my-svc","maintainer":"..."}Logtail 設定の IncludeLabel または ExcludeLabel の値として、出力される実際のラベルのキーと値のペア (例:
com.docker.compose.service=my-svc) を使用します。
Istio サイドカーログが見つからない問題への対処
一致するコンテナログファイルが存在しなくなった場合や、ContainerFilters が Istio サイドカーコンテナと完全に一致しない場合、Istio サイドカーログが収集されないことがあります。
次のチェックを順番に実行してください。
Pod の Deployment または StatefulSet を確認し、Logtail 設定用の正しい環境変数が含まれていることを検証してください。例:
aliyun_logs_reconfig-zltx-test-stdout: "stdout"Logtail または LoongCollector コンポーネントがインストールされ、実行中であることを確認します。その ConfigMap に期待される設定が含まれていることを検証してください。
収集設定では、
ContainerFiltersを使用して Istio サイドカーコンテナの完全一致を設定します。フィルターがアプリケーションコンテナではなく、サイドカーを識別することを確認してください。修正したワークロードまたは収集設定を適用し、一致したコンテナのログファイルがまだ存在することを確認します。新しいサイドカーのログエントリを生成し、SLS がそれを受信するかどうかを確認してください。
マシングループがすべてのコンテナノードを網羅していない問題
症状:マシングループのハートビートは正常ですが、一部のコンテナからのログ収集が停止しています。
この問題は、コンテナが マシングループ に含まれていないサーバーで実行されている場合に発生することがあります。
トラブルシューティングの手順:
関連するすべてのサーバーで、次のコマンドを実行して、コンテナが実際にどのノードで実行されているかを特定してください。
docker ps -a | grep <container-name>コンテナを実行するノードの IP アドレスを、マシン グループに設定されている IP アドレスリストと比較します。コンテナがマシン グループに追加されていないサーバーで実行されている場合は、SLS コンソールの マシングループ にそのサーバーの IP アドレスを追加します。
FAQ:コンテナメタデータのプレビューで Pod が見つからない、または emptyDir からログが収集できないのはなぜですか?
原因: DaemonSet モードで実行されている Logtail は、コンテナ内の emptyDir 一時ストレージに直接アクセスできません。これにより、Logtail はログファイルの読み取りやコンテナメタデータの抽出ができなくなり、コンテナメタデータの プレビュー で Pod が見つかりません。
解決策 1 (推奨):アプリケーションのログ出力を標準出力 (stdout/stderr) へリダイレクト
アプリケーションを修正し、ログをファイルではなく stdout または stderr に書き込むようにしてください。
SLS コンソールで、収集パスを標準の Kubernetes ログパスに設定してください。
/logtail_host/var/log/pods/<namespace>_<pod-name>-<uid>/<container-name>/*.log
解決策 2:アプリケーションがログをファイルに書き込む必要がある場合は、ログボリュームのマウントを emptyDir から hostPath または PVC に変更します。
Pod の仕様で、
emptyDirボリュームをhostPathまたは PVC の定義に置き換えて、ログがホストからアクセス可能なパスに永続化されるようにしてください。SLS の収集パスを、ホスト上の実際のマウントパスを指すように調整してください。例:
/logtail_host/var/log/your-app/*.log
FAQ:コンテナログを収集する際のファイル作成失敗や権限エラーへの対処法
症状:エラーメッセージに、Logtail がコンテナ内に特定の空ファイルを作成する必要があるが、ファイルの作成に失敗したか、権限エラーが報告されたことが示されます。
解決策:
エラーメッセージで指定された空ファイルをコンテナ内に手動で作成してください。
touch <file-path>ファイルの権限を
-rw-r--r--(644) に設定してください。chmod 644 <file-path>コンテナを再起動してください。
代替案:上記の手順を実行しても問題が解決しない場合は、コンテナのログディレクトリをホストマシンにマウントし、対応するホストパスからログを収集するように SLS を設定します。このアプローチは、コンテナ内でのファイル収集よりも安定しています。
FAQ:エラー "parse cri docker line error: invalid CRI log, timestamp not found" への対処法
原因:ログの解析に失敗しました。このエラーは、一般的に複数行ログの設定が正しくないことが原因で発生します。
解決策:
行頭の正規表現を確認して調整するか、複数行モードを無効にします。
YAML 設定の場合:
multiline設定セクションをコメントアウトまたは削除し、設定を再適用します。SLS コンソールの場合:Logtail 設定を開き、複数行モードを無効にします。
[K8s 名前空間の正規表現] およびその他の書式フィールドが正しいことを確認してください。複数の名前空間に一致させるには、
namespace1|namespace2のように、名前空間を垂直バー (|) で区切ります。YAML 設定を変更した後、変更を有効にするために再適用してください。
kubectl apply -f <your-config-file>.yaml
FAQ:JSON 解析プラグインの横に赤い感嘆符が表示され、Logtail 設定が保存できない場合の対処法
症状:Logtail 設定に JSON 解析プラグインを追加した後、プラグインアイコンの横に赤い感嘆符が表示され、ダイアログボックスで設定を保存できません。
原因:赤い感嘆符は通常、プラグインが設定されていないか、設定が変更されたが適用されていないことを示します。
解決策:
Logtail 設定編集ページで、デフォルトで追加されている JSON 解析プラグインを削除してください。
再度 JSON 解析プラグインを手動で追加し、ログサンプルや解析ルールなど、すべての必須フィールドを入力してください。
設定が完了すると、赤い感嘆符が消え、Logtail 設定を保存できるようになります。
JSON 解析プラグインの後に時間解析プラグインを追加するのは標準的な方法です。時間解析プラグインを使用すると、ログコンテンツから時間フィールドを抽出し、ログ時間として使用できます。
FAQ:複数の Logtail 設定が同じファイルに一致するため (MULTI CONFIG MATCH ALARM)、データが収集されない場合の対処法
症状:Logtail の運用ログに MULTI CONFIG MATCH ALARM アラートが表示され、ターゲットファイルからデータが収集されません。
原因:デフォルトでは、1 つのログファイルは 1 つの Logtail 設定にしか一致しません。複数の Logtail 設定が同じファイルに一致する場合、そのうちの 1 つしか有効になりません。他の設定はデータを収集できず、MULTI CONFIG MATCH ALARM アラートがトリガーされます。
解決策:
冗長な Logtail 設定の削除: Simple Log Service コンソールで、マシングループ に関連付けられているすべての Logtail 設定を確認します。各ファイルが 1 つの設定のみに一致するように、重複した、または未使用の設定を削除します。
Pod 名によるマッチングの分割:同じファイルに対して複数の設定が必要な場合 (たとえば、Pod 名で収集を分割する場合) は、公式ドキュメントの説明に従って設定を変更します。各 Logtail 設定が、より正確なパスまたはラベルフィルターを介して独自のターゲットファイルのみに一致するようにし、パスの重複を避けてください。
変更後、Logtail の運用ログを確認し、MULTI CONFIG MATCH ALARM アラートが消え、データが期待どおりに収集されることを確認してください。
FAQ: コンテナログの収集時に Logtail で発生する no such file or directory エラーの対処方法
症状:Logtail の運用ログに no such file or directory エラーが含まれており、ターゲットのコンテナログを収集できません。
原因:ターゲットの収集パスがノード上に存在しません。この問題は通常、Kubernetes の Pod のライフサイクルまたはログローテーションメカニズムに関連しています。
解決策:
Pod がまだ存在するかどうかを確認する:Pod が削除されている場合、対応するログパスはもはや存在しないため、エラーは無視できます。Pod がまだ実行中の場合は、サーバー (ノード) にログインし、実際のログパスが存在するかどうかを確認します。
可能な場合はコンテナの stdout 収集を使用する:ACK コンソールでログ収集設定を作成する際に、コンテナ内部のファイルパスに依存するのではなく、[コンテナ Stdout] タイプを選択し、コンテナのラベルまたはコンテナ名でターゲットコンテナを照合してください。
ファイル収集が必要な場合の設定提案:ワイルドカードパス (例:
/logtail_host/var/log/pods/*/*.log) を使用し、Logtail 設定で新しいファイルの自動検出を有効にして、Logtail がログローテーションまたは Pod の再作成後に新しいパスを追跡できるようにしてください。Logtail 設定がマシン グループに適用されていることを確認します: Logtail 設定が、ターゲット ポッドを含む マシングループ にバインドされていることを確認してください。
Logtail の運用ログを確認する:すでに破棄された Pod に多数のエラーが集中している場合は、それらを無視できます。エラーが持続し、Pod がまだ実行中の場合は、収集パスを修正するか、ノードのマウントを確認してください。
FAQ: logfiletoobig が原因で Logtail がファイルをスキップし、収集が中断された場合の対処方法
現象: Logtail 操作ログに logfiletoobig アラートが表示され、対象ファイルがスキップされ、ログ収集が中断されます。
原因:ターゲットログファイルのサイズが Logtail のデフォルト制限を超えています。Logtail は安定性を保護するためにファイルをスキップします。
解決策:
Logtail 収集パラメーターの調整: Logtail 設定または マシングループ のグローバルパラメーターで、次の変更を行います。
MaxLogFileSizeを、たとえば1GBに増やして、大容量ファイルがスキップされるのを防ぎます。ローテーションされたファイルの追跡を改善するには、たとえば
MaxLogFileInodeCacheSizeを2000に増やします。Logtail がコンテナのログパスを自動的に検出し、新しいポッドの追跡エントリを自動的に作成できるように、
EnableContainerDiscoveryをtrueに設定します。
再スキャンをトリガーする:ACK クラスターで、次のコマンドを実行して loongcollector-ds (または Logtail-ds) Pod を削除します。DaemonSet は Podを自動的に再作成し、すべてのコンテナログパスを再スキャンします。
kubectl delete pod -n kube-system -l k8s-app=loongcollector-ds
ACK の補足的なトラブルシューティング
ACK クラスターで、上記の手順を確認してもログ収集でデータが返されない場合は、次の 2 つの項目を確認してください。
ACK CRD 収集設定の確認:次のコマンドを実行して、ACK クラスターの CRD 収集設定を表示してください。
kubectl get ClusterAliyunPipelineConfig -A出力内の Logstore と収集ルールが期待どおりであることを確認してください。
コンテナイメージのボリューム宣言の確認:コンテナイメージに対して
docker inspectコマンドを実行し、Config.Volumesフィールドを確認してください。docker inspect <image-name> | grep -A5 VolumesConfig.Volumesが空でない場合、イメージによって宣言されたVOLUMEがログファイルのパスを上書きする可能性があります。VOLUME宣言を削除するか、ボリュームをemptyDirにマウントしてください。
その他のメンテナンス操作
Logtail コンテナへのログイン
標準 Docker
ホストで、次のコマンドを実行して Logtail コンテナを見つけます。
docker ps | grep logtail出力例:
223****6e registry.cn-hangzhou.aliyuncs.com/log-service/logtail "/usr/local/ilogta..." 8 days ago Up 8 days logtail-iba次のコマンドを実行して、Logtail コンテナで bash シェルを起動します。
docker exec -it 223****6e bash223****6eを実際のコンテナ ID に置き換えてください。
Kubernetes
次のコマンドを実行して Logtail Pod を見つけます。
kubectl get po -n kube-system | grep logtail出力例:
logtail-ds-****d 1/1 Running 0 8d logtail-ds-****8 1/1 Running 0 8d次のコマンドを実行して Pod にログインします。
kubectl exec -it -n kube-system logtail-ds-****d -- bashlogtail-ds-****dを実際の Pod ID に置き換えてください。
Logtail ランタイムログの表示
Logtail は、そのログを Logtail コンテナの /usr/local/ilogtail/ ディレクトリに保存します。ログファイルは ilogtail.LOG と logtail_plugin.LOG です。
Logtail コンテナにログインします。詳細については、「Logtail コンテナへのログイン」をご参照ください。
/usr/local/ilogtail/ ディレクトリに移動します。
cd /usr/local/ilogtaililogtail.LOG と logtail_plugin.LOG ファイルを確認します。
cat ilogtail.LOG cat logtail_plugin.LOG
Logtail コンテナの標準出力 (stdout)
Logtail コンテナの標準出力は、トラブルシューティングに役立つ情報を提供しません。以下の内容は無視してかまいません。
start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is runningKubernetes コンポーネントのステータスの確認
次のコマンドを実行して、SLS のデプロイのステータスと情報を表示してください。
kubectl get deploy -n kube-system | grep -E 'alibaba-log-controller|loongcollector-operator'次の出力が表示されます。
NAME READY UP-TO-DATE AVAILABLE AGE
alibaba-log-controller 1/1 1 1 11d次のコマンドを実行して、DaemonSet リソースのステータス情報を表示してください。
kubectl get ds -n kube-system | grep -E 'logtail-ds|loongcollector-ds'次の出力が表示されます。
NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE
logtail-ds 2 2 2 2 2 **ux 11dLogtail のバージョン、IP アドレス、および起動時刻
ホストで、次のコマンドを実行して Logtail のバージョン、IP アドレス、および起動時刻を表示してください。
この情報は Logtail コンテナの
/usr/local/ilogtail/app_info.jsonファイルに保存されています。kubectl exec logtail-ds-****k -n kube-system cat /usr/local/ilogtail/app_info.json出力例:
{ "UUID" : "", "hostname" : "logtail-****k", "instance_id" : "0EB****_172.20.4.2_1517810940", "ip" : "172.20.4.2", "logtail_version" : "0.16.2", "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64", "update_time" : "2018-02-05 06:09:01" }
ACK クラスター内の Pod ログのトラブルシューティング情報の取得
ACK クラスター内の Pod のログ収集が異常な場合、以下の手順で自己トラブルシューティングまたは技術サポートへの提供に必要な基本情報を取得できます。
ステップ 1:Logtail または LoongCollector の Pod 名を見つけます。
kubectl get pods -n kube-system | grep loongcollector手順 2: app_info.json ファイルから Logtail または LoongCollector インスタンスの IP アドレスを取得します。
kubectl exec <pod-name> -n kube-system cat /usr/local/ilogtail/app_info.json返される JSON 出力の ip フィールドは、Logtail インスタンスの IP アドレスです。
サポートを求める場合、トラブルシューティングに役立つように、以下の情報を提供してください。
SLS プロジェクト名
Logtail 収集設定名
ターゲット Pod 名
ターゲットコンテナ名
誤って削除された CRD Logstore への対処法
カスタムリソース定義 (CRD) によって自動的に作成された Logstore を削除すると、収集されたデータは回復不能になり、その Logstore の CRD 設定は無効になります。ログ収集の問題を防ぐには、次のいずれかの解決策を選択してください。
CRD 設定で、削除した Logstore の代わりに別の Logstore を使用してください。
alibaba-log-controller ポッドを再起動します。
次のコマンドを実行して Pod を見つけます。
kubectl get po -n kube-system | grep alibaba-log-controller
よくある質問
FAQ:LoongCollector または Logtail イメージをプルするために docker pull を実行すると、ホスト上の他のサービスに影響しますか?
結論: docker pull コマンドのみを実行して LoongCollector または Logtail イメージをプルしても、ホストで実行されている他のサービスに影響はありません。これは Alibaba Cloud ECS インスタンスとオンプレミスサーバーの両方に適用されます。docker pull コマンドは、イメージレイヤーをローカルイメージリポジトリにダウンロードするだけです。コンテナを起動したり、追加の CPU やメモリリソースを消費したりすることはありません。
注意事項:
後で
docker runを実行してコンテナを起動する際には、新しいコンテナが既存のワークロードと競合しないように、ホストに十分な CPU およびメモリリソースがあることを確認してください。コンテナのポートマッピングが、ホスト上で既存のサービスによってすでに使用されているポートと競合していないか確認してください。
Kubernetes でログ収集コンポーネントを長期間実行したい場合は、ACK コンソールの [コンポーネント管理] を通じて LoongCollector を DaemonSet モードでインストールすることを推奨します。これにより、クラスターがリソースを統一的にスケジュールできます。
FAQ:実行中でない Pod はファイルのログ収集に影響しますか?
結論:はい、影響します。LoongCollector と Logtail はコンテナ内からファイルを収集します。サービスの起動に失敗し、Pod が実行中でない場合、コンテナはログファイルまたはそのディレクトリを作成しない可能性があります。コレクターは、存在しないパスからファイルを読み取ったり収集したりすることはできません。
ファイルのログ収集を検証するには、サービスの起動コマンドを一時的に設定してコンテナを実行させ続けてください。例:
sleep 3600Pod が実行中の状態になった後、設定されたファイルパスにテストログエントリを手動で書き込みます。その後、LoongCollector または Logtail が新しいエントリを収集するかどうかを検証してください。テスト後、元の起動コマンドに戻してください。
FAQ:メソッド名や他のビジネスフィールドでコンテナの stdout ログをクエリできないのはなぜですか?
SLS は、収集されたログにフィールドが存在し、そのインデックスが作成されている場合にのみフィールドをクエリできます。コンテナの stdout またはアプリケーションログにメソッド名、呼び出し元情報、またはその他のビジネスフィールドが含まれていない場合、SLS でそのフィールドを直接クエリすることはできません。
NGINX や Spring Cloud Gateway などのアプリケーションまたはゲートウェイのロギング設定を確認してください。必要なすべてのビジネスフィールドが stdout または収集対象のログファイルに書き込まれるようにしてください。
ログコンテンツフィールドは、アプリケーションまたはゲートウェイによって出力されるテキストの一部です。メタデータタグは、収集中にログコンテキストをエンリッチするために付加されます。タグをエンリッチしても、元のログコンテンツに欠落しているメソッド名や呼び出し元フィールドが作成されるわけではありません。