マルチテナント機能利用ガイド
ダウンロード
フォーカスモード
フォントサイズ
概要
本文書では、LogListenerの新しいアーキテクチャ（バージョン3.4.0以上）におけるマルチテナント機能について、機能特性、設定方法、利用シーンを含めて詳しく説明し、ユーザーがアカウント間のログ収集と管理を実現できるようにします。
機能特性
マルチテナント対応：単一のLogListenerインスタンスは、複数のTencent Cloudアカウント（UIN）およびリージョンに同時にログデータを報告できます。
集中収集：グループ化ログ管理、アカウント間集中収集などのビジネスシナリオ要件に対応します。
柔軟な設定：テナント設定の動的な追加、変更、削除に対応しており、サービスを再起動する必要はありません。
前提条件
マルチテナント機能を使用する前に、以下の条件を満たしていることを確認してください：
バージョン：LogListener 新アーキテクチャ（バージョン3.4.0以上）がインストールされています。
権限：対象アカウントのSecretId/SecretKeyまたは一時キーを取得済みです。キーはAPIキー管理から取得できます。
ネットワーク設定：マルチテナント設定は現在のインスタンスのネットワークアクセス方式を変更しません。初期化時のデフォルトのネットワークアクセス方式が優先されます。
地域制限：クロスリージョン転送が発生する場合、コレクターのインストール初期化時にネットワーク転送方式を「外部ネットワーク」に指定してください。インストール済みのコレクターに対しては、コレクター設定を変更して「外部ネットワーク」に指定できます。インストール初期化については新アーキテクチャLogListenerのインストールを参照してください。コレクターがインストール済みの場合、コレクター設定の変更についてはLogListener設定ガイドを参照してください。
LogListener新アーキテクチャへのインストールとアップグレード
新規インストールシナリオ
LogListenerインストールドキュメントに従って、新アーキテクチャバージョンのインストールを完了します。
アップグレードシナリオ
LogListenerアップグレードガイドを参照して、LogListenerを新しいアーキテクチャにアップグレードし、バージョン3.4.0以上にアップグレードしてください。
マルチテナント設定
1. LogListenerのインストールディレクトリ（デフォルトパスは
/opt/loglistener）に入ります。2. 以下のコマンドを実行して、新しいテナント設定を追加します：
./loglistener ak -a add -u ${uin} -r ${region} -s ${secret_id} -k ${secret_key}
パラメータの説明は以下の通りです：
パラメータ | 必須/任意 | 説明 |
uin | はい | 対象テナントのメインアカウントUIN。 |
region | はい | CLSが所在するリージョン（例：ap-guangzhou）です。 |
secret_id | はい | TencentCloud APIキーの一部であり、SecretIdはAPI呼び出し元の識別に使用されます。TencentCloud APIキーに関連付けられたアカウントに、対応するLogListenerログ収集権限が付与されていることを確認してください。 |
secret_key | はい | TencentCloud APIキーの一部であり、SecretKeyは署名文字列の暗号化とサーバー側での署名文字列の検証に使用されるキーです。TencentCloud APIキーに関連付けられたアカウントに、対応するLogListenerログ収集権限が付与されていることを確認してください。 |
設定反映に関する説明
コマンドが正常に実行されると、LogListenerは複数のアカウントおよび対応するリージョンに同時にログを報告します。
対象アカウントのCLSコンソールで、このサーバーを対応するマシングループに追加すると、収集設定を正常に配信できます。
現在の設定情報は
/opt/loglistener/conf/server_configディレクトリに保存されます。下図のように、server_configに{Uin}#{Region}形式のファイルが追加されます。これは、このテナントの収集設定の保存場所です。
テナント管理
コマンドパラメータの説明
LogListenerのインストールディレクトリ（デフォルトパスは
/opt/loglistener）に入ります。テナントの管理はすべて./loglistener akコマンドで行います。パラメータは以下の通りです：パラメータ | 説明 |
-a, --action | 操作行為は、add、update、deleteをサポートします。 |
-u, --uin | 所属するメインアカウントのUIN。 |
-r, --regions | 設定されたリージョンです。 |
-s, --secretid | TencentCloud APIキーの一部であり、SecretIdはAPI呼び出し元の識別に使用されます。TencentCloud APIキーに関連付けられたアカウントに、対応するLogListenerログ収集権限が付与されていることを確認してください。 |
-k, --secretkey | TencentCloud APIキーの一部であり、SecretKeyは署名文字列の暗号化とサーバー側での署名文字列の検証に使用されるキーです。TencentCloud APIキーに関連付けられたアカウントに、対応するLogListenerログ収集権限が付与されていることを確認してください。 |
-t, --token | 一時キーToken（オプション）、一時キーが必要なシナリオでのみ必要です。 |
テナント設定の変更
1. 以下のコマンドを実行して、指定したテナントのリージョン設定を変更します。
./loglistener ak -a update -u ${テナントのメインアカウントUIN} -r ${新しいリージョン}
2. 変更後、LogListenerは新しいリージョン設定に従ってデータを報告します。サービスを再起動する必要はありません。
テナント設定の削除
以下のコマンドを実行して、指定したテナント設定を削除します。
./loglistener ak -a delete -u ${テナントのメインアカウントUIN}
フィードバック