マシングループのハートビートは、サーバーと Simple Log Service (SLS) との間の通信ステータスを反映します。ハートビートが異常な場合、データを SLS に送信できません。このトピックでは、異常なハートビートの原因を説明し、一般的なユースケースのソリューションを提供します。
異常なハートビートの原因
サーバー上の LoongCollector は、次の設定項目を使用して宛先プロジェクトを識別し、ハートビートを報告します。異常なハートビートのトラブルシューティングには、設定項目の確認とネットワーク接続の検証が含まれます。
SLS プロジェクトを所有する Alibaba Cloud アカウント: このアカウントは、サーバーにアクセスしてそのログを収集する権限を持っている必要があります。
プロジェクトのリージョンとネットワークタイプ: SLS エンドポイントは、リージョンとネットワークタイプに基づいて動的に生成されます。サーバーがエンドポイントに接続できることを確認してください。詳細については、「ネットワークタイプとエンドポイント」をご参照ください。
カスタム識別子または IP アドレス: ハートビートは、IP アドレスまたはカスタム識別子を使用してサーバーをマシングループに関連付けることによって確立されます。
ハートビート確立手順
LoongCollector は、その構成を読み取って、Alibaba Cloud アカウント ID、エンドポイント、およびサーバーの IP アドレスまたはカスタム識別子を取得します。
LoongCollector は、この情報を含むハートビートを指定されたリージョンのプロジェクトに報告します。
SLS バックエンドは、LoongCollector によって報告された IP アドレスまたはカスタム識別子をマシングループの構成と比較します。
情報が一致する場合、ハートビートは 1 つ以上の照合プロジェクトで正常に確立されます。マシングループのハートビートステータスは OK に変わります。
異常なハートビートの一般的なユースケース
新しいサーバーのハートビートが FAIL になる
ハートビートステータスが FAIL の場合、最初のハートビートの確立に時間がかかる場合があります。 約 2 分待ってから、ハートビートステータスを更新します。 ステータスがまだ FAIL の場合は、次の手順を実行します。
LoongCollector の正しいインストールユースケースを選択したことを確認します。ユースケースが正しい場合は、次のステップに進みます。それ以外の場合は、LoongCollector をアンインストールしてから再インストールします。
インストール方法
ユースケース
この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトの両方が同じ Alibaba Cloud アカウントに属し、同じリージョンにある場合にのみ適用されます。
この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトの両方が同じ Alibaba Cloud アカウントに属しているが、異なるリージョンにある場合に適用されます。
この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトの両方が同じリージョンにあるが、異なる Alibaba Cloud アカウントに属している場合に適用されます。
この方法は、サーバーが Alibaba Cloud ECS インスタンスではない場合、たとえば、オンプレミスサーバーまたは別のクラウドプロバイダーのサーバーである場合に適用されます。
この方法は、サーバーが Alibaba Cloud ECS インスタンスであるが、ECS インスタンスとプロジェクトが異なる Alibaba Cloud アカウントに属し、異なるリージョンにある場合に適用されます。 この場合、サーバーはオンプレミスサーバーとして扱うことができます。
サーバーで、
sudo /etc/init.d/loongcollectord statusコマンドを実行して、LoongCollector のステータスを確認します。 `loongcollector is running` が返された場合、LoongCollector は起動しています。 そうでない場合は、次のコマンドを実行して LoongCollector を起動します。Logtail コレクターを使用する場合は、
sudo /etc/init.d/ilogtaild statusを実行してステータスを確認し、sudo /etc/init.d/ilogtaild startを実行して開始します。sudo /etc/init.d/loongcollectord startプロジェクトとサーバーが異なる Alibaba Cloud アカウントに属しているクロスアカウントのユースケースでは、プロジェクトのアカウントにサーバーへのアクセスとログ収集の権限を付与するために、ユーザー ID ファイルを手動で構成する必要があります。
リージョンとネットワークタイプが正しく、エンドポイントに接続できることを確認します。サーバー上の
/usr/local/ilogtail/ilogtail_config.jsonファイルに、SLS プロジェクトの リージョン ID と一致する正しいregion情報が含まれているかどうかを確認します。一致する場合は、次のステップに進みます。一致しない場合は、変更します。Simple Log Service コンソール にログインします。 [プロジェクト] セクションで、ターゲットプロジェクトをクリックします。
プロジェクト名の右側にある
アイコンをクリックして、プロジェクトの概要ページに移動します。[エンドポイント] セクションで、現在のプロジェクトのドメイン名情報を表示します。
${project_name}をプロジェクト名に、${domain_name_information}をインターネットエンドポイントに置き換えます。次に、サーバーでコマンドを実行します。curl https://${project_name}.${domain_name_information}{"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}}のような応答が返された場合、ネットワーク接続は正常です。それ以外の場合は、宛先アドレスがブロックされているかどうかを確認し、他のネットワークチェックを実行します。たとえば、ポート 80 (HTTP) と 443 (HTTPS) がアウトバウンドトラフィックに対して開いているかどうかを確認し、DNS とセキュリティグループの構成を確認します。このエラーは想定されており、ネットワーク接続が機能していることを示します。このエラーは、curl コマンドがネットワーク接続のみをテストし、有効なリクエストに必要な API パラメーターを含んでいないために発生します。
/usr/local/ilogtail/ilogtail_config.jsonのパラメーターを変更します。config_servers: このパラメーターは、収集構成を取得するパスを指定します。 値を
"http://logtail.${domain_name_information}"に変更します。ここで、${domain_name_information}はインターネットエンドポイントです。data_servers:
region: このパラメーターは、データ転送のリージョンを指定します。値を
"${RegionID}"に変更します。ここで、${RegionID}は SLS プロジェクトの リージョン ID です。endpoint_list: このパラメーターは、データ転送のパスを指定します。 値を
"${domain_name_information}"に変更します。ここで、${domain_name_information}はインターネットエンドポイントです。
変更を保存した後、LoongCollector を再起動します。
Logtail コレクターを使用する場合は、
sudo /etc/init.d/ilogtaild restartsudo /etc/init.d/loongcollectord restart
カスタム識別子または IP アドレスの値を確認します。
Simple Log Service コンソール にログインします。 [プロジェクト] セクションで、ターゲットプロジェクトをクリックします。
左側のナビゲーションウィンドウで、[
] リソース > マシングループ を選択します。 [マシングループ] ページで、ターゲットマシングループをクリックします。[マシングループ設定] ページで、[マシングループ識別子] を表示し、対応する操作を実行します。
カスタム識別子
サーバー上に
/etc/ilogtail/user_defined_idファイルが存在することを確認します。 存在しない場合は、作成します。カスタム識別子として、カスタム文字列をファイルに書き込みます。 この例では、
user-defined-test-1を使用します。# カスタム文字列を指定されたファイルに書き込みます。 echo "user-defined-test-1" > /etc/ilogtail/user_defined_id[カスタム識別子] をカスタム文字列に設定します。 この例では、値は
user-defined-test-1です。
IP アドレス
サーバー上の
/usr/local/ilogtail/app_info.jsonからipフィールドの値を [IP アドレス] フィールドに追加します。IP 値ルール: サーバーの /etc/hosts ファイルでホスト名と IP アドレスのマッピングを設定した場合、マッピングされた IP アドレスが自動的に取得されます。 ホスト名マッピングが設定されていない場合は、最初の NIC の IP アドレスが自動的に取得されます。 working_ip パラメーターが /usr/local/ilogtail/ilogtail_config.json で設定されている場合、その値はサーバーの IP アドレスとして使用されます。 これらの方法の少なくとも 1 つで IP アドレスを取得できることを確認してください。 そうでない場合、ip フィールドは空になり、ハートビートを確立できません。
ハートビートは以前は成功したが、現在は FAIL である
以前に成功したハートビートは、設定項目が正しいことを示します。マシングループがカスタム識別子を使用している場合、構成は静的です。問題はネットワーク関連である可能性が高いです。SLS エンドポイントへのネットワーク接続を確認してください。マシングループが IP アドレスを使用している場合、FAIL ステータスは IP アドレスの競合または IP アドレスの変更が原因である可能性が最も高いです。問題を解決するには、次の手順を実行します。
サーバーで、LoongCollector を再起動して最新の IP アドレス情報を取得します。
Logtail コレクターを使用する場合は、
sudo /etc/init.d/ilogtaild restartsudo /etc/init.d/loongcollectord restartサーバーで、
/usr/local/ilogtail/app_info.jsonファイルのipフィールドの情報を確認します。IP 値ルール: サーバーの /etc/hosts ファイルでホスト名と IP アドレスのマッピングを設定した場合、マッピングされた IP アドレスが自動的に取得されます。 ホスト名マッピングが設定されていない場合は、最初の NIC の IP アドレスが自動的に取得されます。 working_ip パラメーターが /usr/local/ilogtail/ilogtail_config.json で設定されている場合、その値はサーバーの IP アドレスとして使用されます。
Simple Log Service コンソール にログインします。 [プロジェクト] セクションで、ターゲットプロジェクトをクリックします。
左側のナビゲーションウィンドウで、[
] リソース > マシングループ を選択します。 [マシングループ] ページで、ターゲットマシングループをクリックします。[マシングループ設定] ページで、[IP アドレス] フィールドに
/usr/local/ilogtail/app_info.jsonからipフィールドの値が含まれているかどうかを確認します。 含まれていない場合は、ipフィールドの値を [IP アドレス] フィールドに追加します。IP アドレスが一致してもハートビートが FAIL のままである場合は、サーバーの IP が不安定であるか競合している可能性があります。より信頼性の高い識別のために、カスタム識別子への切り替えを検討してください。
マシングループ識別子タイプを切り替えた後、ハートビートが FAIL である
IP アドレスの競合または変更が発生した場合、IP ベースのマシングループは適切ではなくなります。カスタム識別子を使用するマシングループに切り替える必要があります。マシングループのタイプを切り替えても、ネットワーク接続、Alibaba Cloud アカウント情報、リージョンおよびネットワークタイプの設定には影響しません。したがって、カスタム識別子の値が正しいことのみを確認する必要があります。
/etc/ilogtail/user_defined_idファイルが存在することを確認します。存在しない場合は、作成します。カスタム識別子として、カスタム文字列をファイルに書き込みます。この例では、
user-defined-test-1を使用します。# 指定されたファイルにカスタム文字列を書き込みます。 echo "user-defined-test-1" > /etc/ilogtail/user_defined_idSimple Log Service コンソール にログインします。 [プロジェクト] セクションで、対象のプロジェクトをクリックします。
左側のナビゲーションウィンドウで、
リソース > マシングループ を選択します。 [マシングループ] ページで、対象のマシングループをクリックします。[マシングループ設定] ページで、次の 2 つのパラメーターの値を確認します。値が正しくない場合は、右上隅にある [変更] をクリックし、必要な変更を加えて保存します。
マシングループ識別子: カスタム識別子。
カスタム識別子: カスタム文字列。この例では、値は
user-defined-test-1です。
よくある質問
すべての構成が正しいのに、なぜハートビートステータスが FAIL になるのですか？
構成が正しく、ネットワークが正常であることを確認した場合、次の 2 つの理由でハートビートステータスが FAIL になることがあります。
コレクション構成がリージョンで長期間適用されていないため、コレクターはハートビートの頻度を減らします。
サーバーの負荷を軽減するために、コレクターは構成が返されない場合、リージョンからの構成リクエストの頻度を減らします。 リクエスト間隔は最大 12 分まで増加する可能性があります。 この間隔がリージョンのハートビート FAIL しきい値を超えると、ハートビートステータスは FAIL に変わります。
ソリューション: FAIL のハートビートステータスは無視してください。サーバーを含むマシングループにコレクション構成を適用します。ハートビートは、リージョンへの次のリクエスト中に回復します。ハートビートをすぐに回復するには、コレクターを再起動します。
アクティブな構成が
ilogtail_config.jsonファイルと一致しません。例：コレクターはデフォルト以外の構成で起動します。 その後、
ilogtail_config.jsonファイルが変更されますが、コレクターは再起動されません。確認方法：
最も直接的な方法は、コレクターを再起動して最新の構成を自動的にロードすることです。
ログ収集への影響が懸念される場合は、
/usr/local/ilogtail/ilogtail.LOGファイルを表示します。ファイルの先頭から、キーワードload logtail config fileを検索します。その行のログエントリには、使用中の構成が含まれています。ローカルファイルと一致するかどうかを確認します。