収集自己チェックツール利用ガイド
ダウンロード
フォーカスモード
フォントサイズ
非TKE環境でのLogListenerログ収集自己チェックツールの使用
注意事項
オペレーティングシステム：Linuxシステムのみをサポートします。
実行権限：ダウンロード後、実行権限を付与する必要があります。
chmod +x loglistener-checkを実行します。前提条件：実行前に、現在のマシンにLogListenerがインストールされ、実行されていることを確認してください。LogListenerがインストールされていない場合は、インストールおよびアップグレードガイドを参照してください。ツールはLogListenerのインストールディレクトリと設定ファイルを読み取る必要があるため、LogListenerが配置されているマシン上で直接実行することをお勧めします。
ネットワーク要件：ツールの実行時にCLSサービスへアクセスしてバージョンおよび設定の検証を行う必要があります。マシンのネットワークがTencent Cloud関連ドメインへ正常にアクセスできることを確認してください。
ツールのダウンロード
収集セルフチェックツールをダウンロードします。ダウンロードアドレス：
https://mirrors.tencent.com/install/cls/loglistener-check/linux/loglistener-check使用を開始
関連コマンド
Usage of ./loglistener-check:-h, --help help for loglistener--root_dir string (optional) install loglistener root dir (default is /usr/local/loglistener-*)--topic string (optional) topic ID
主なパラメータの説明は以下の通りです：
パラメータ | タイプ | 必須/任意 | 説明 |
--root_dir | string | いいえ | LogListener のインストールルートディレクトリを指定します。デフォルト値は /usr/local/loglistener-* です（ツールはこのパスパターンに一致するインストールディレクトリを自動的に検出します）。カスタムパスで LogListener をインストールした場合は、完全なインストールパスを手動で指定してください。例えば、デフォルトパスで LogListener 2.7.2 をインストールした場合、そのルートディレクトリは /usr/local/loglistener-2.7.2 です。 |
--topic | string | いいえ | このパラメータを指定しない場合、ツールはこのマシン上で関連付けられているすべてのログトピックをチェックします。指定した場合、その Topic に関連する収集設定のみをチェックし、チェック範囲がより正確になります。 |
例
チェックツールを使用して、チェックツールが提示する問題を確認し、提供された解決策に基づいて問題を解決します。例えば、デフォルトパラメータを使用したチェック結果の例です。
チェック結果：
現在のマシンにインストールされているLogListenerのバージョンが低すぎます。チェックツールが新バージョンを検出したため、アップグレードを推奨します。新バージョンでは多くの問題が修正され、多くの新機能が追加されています。
inotifyパラメータ設定が推奨値に適合していません。ユーザーによる変更を推奨します。変更しない場合、ログ収集に影響を与える可能性があります。
TKE環境でのLogListenerログ収集自己チェックツールの使用
注意事項
オペレーティングシステム：Linux、macOS、Windowsシステムをサポートします。
実行権限：ダウンロード後、実行権限を付与する必要があります。
chmod +x detect-toolを実行します。前提条件：実行前に、kubectlを通じて対象のTKEクラスタへ正常に接続されていることを確認してください。ツールはkubeconfig設定ファイルに依存してクラスタリソースへアクセスします。
ネットワーク要件：ツールの実行時にKubernetes API ServerおよびCLSサービスへのアクセスが必要です。実行環境のネットワークが正常に接続されていることを確認してください。
ツールのダウンロード
お使いのオペレーティングシステムに応じて、対応するバージョンの収集セルフチェックツールをダウンロードします：
Linux：
https://mirrors.tencent.com/install/cls/detect-tool/linux/detect-toolmacOS：
https://mirrors.tencent.com/install/cls/detect-tool/mac/detect-toolWindows：
https://mirrors.tencent.com/install/cls/detect-tool/windows/detect-tool使用を開始
TKEクラスタへの接続
1. TKEコンソールにログインします。
2. 左側のナビゲーションバーでクラスタを選択し、クラスタ管理ページに入ります。
3. 接続するクラスタを見つけ、そのID/名前をクリックして、クラスタ管理ページに入ります。
4. 左側のナビゲーションバーで基本情報をクリックし、基本情報ページに移動します。
5. クラスタ APIServer 情報欄で、TKEの指示に従い、kubectlを使用してTKEクラスタに接続します。具体的な操作については、Kubeconfigの設定を参照してください。
関連コマンド
Usage of ./detect-tool:--kubeconfig string (optional) Path to a kubeconfig file, specifying how to connect to the API server. (default "/root/.kube/config")--logConfig string (optional) logconfig name--namespace string (optional) pod name namespace--pod string (optional) pod name--topic string (optional) topic id
主なパラメータの説明は以下の通りです：
パラメータ | タイプ | 必須/任意 | 説明 |
--kubeconfig | string | いいえ | Kubernetes への接続に使用する設定ファイルのパスです。デフォルト値は /root/.kube/config です。通常、kubectl が正常にクラスタへ接続した後は、特別な設定や指定は不要です。 |
--logConfig | string | いいえ | 収集設定（LogConfig）名を指定し、検出する収集設定を指定します。 kubectl get logconfigs コマンドで現在のクラスタ内の収集設定一覧を確認できます。 |
--pod | string | いいえ | Pod名を指定し、検出するPodを指定します。Podを指定した場合は、必ず --namespaceも指定する必要があります。 |
--namespace | string | いいえ | 検出するPodが存在するnamespaceを指定します。namespaceを指定した場合は、必ず --podも指定する必要があります。 |
--topic | string | いいえ | 確認する必要があるログトピック（Topic）IDを指定し、そのTopicに関連付けられた収集設定を確認します。1つのクラスタに複数の収集設定が同じTopicに関連付けられている場合があります。Topic IDはCLSコンソールで取得できます。具体的な操作についてはログトピックをご参照ください。 |
例
チェックツールを使用して、チェックツールが提示する問題を確認し、提供された解決策に基づいて問題を解決してください。
示例1：収集設定とPodチェックを指定します。
./detect-tool --logConfig=cls-log-config --pod=cls-provisioner-xxxxxxxxxxx --namespace=kube-system
示例2：指定topicをチェックします。
./detect-tool --topic=1a2763e2-75f9-4a16-b921-1a80e3de7356
ログコンポーネントのバージョンアップグレードを推奨します。現在のクラスタは最新バージョンではありません。
2つの収集設定が1つのtopicに関連付けられています。複数の収集設定が同じファイルを収集しないようにすることをお勧めします。
フィードバック