Monitor Docker EE 2.x および UCP 3.x の監視
apmsaas
HID_ee2xucp3x
新しく結合されるすべてのワーカ ノードは、Kubernetes、Swarm、または両方のワークロード(混在モード)をスケジュールする準備ができています。Docker Monitor を使用すると、Swarm ノード上で実行されているコンテナを監視できます。Kubernetes Monitor を使用すると、Kubernetes ノード上で実行されているポッドを監視できます。
Swarm ノード上のコンテナの監視
Swarm ノードにインストールされているコンテナのパフォーマンスおよび稼働状況を監視するには、Docker Monitor をインストールします。
以下の手順に従います。
- DX SaaSで、[エージェント]を選択し、[エージェントのダウンロード]を選択します。
- [Docker Monitor EE2.x UCP 3.x Monitor]を選択します。
- エージェントを選択した後に表示されるインストール手順に従います。
- (オプション) YML ファイルで指定されている環境変数に加えて、インフラストラクチャ エージェント プロファイル内のプロパティを使用して環境を設定します。インフラストラクチャ エージェントのプロパティの詳細については、「インフラストラクチャ エージェント プロパティ リファレンス」を参照してください。インフラストラクチャ エージェント プロパティを環境変数としてinstall.ymlファイルに渡すには、environmentセクションの最後に変数を追加します。YML 形式では、プロパティ名に区切り文字「.」は使用できません。プロパティ名のドットをアンダースコアに置き換える必要があります。たとえば、エージェント名およびプロキシ サーバを設定するには、introscope.agent.agentNameおよびintroscope.agent.enterprisemanager.transport.http.proxy.hostプロパティを以下のように使用します。environment: - agentManager_url_1=[AGENT_MANAGER_URL] - containerflow=enabled - interval=90 - type=Docker - introscope_agent_agentName=example_agent_name - introscope_agent_enterprisemanager_transport_http_proxy_host=example_proxy_server.com
- (オプション)ホスト モニタをインストールすると、コンポーネント ビュー内のホスト関連情報にはStorageNameメトリックが含まれます。UNIX または Linux システムでは、ストレージ フィルタを設定して、このメトリックに関連付けられているように表示されるマウント ポイントを設定できます。ストレージ フィルタを設定するには、以下の環境変数を使用します。
- storage_mount_filterStorageNameメトリックの考慮対象から削除するマウント ポイントを指定するための変数。1 行に 1 つのマウント ポイント、または 1 行に複数のマウント ポイントをカンマで区切って指定できます。
- storage_outofbox_filter_enabled有効にされている場合、以下のマウントを除外する標準装備のフィルタ。
- devicemapper/mnt
- docker/containers
- docker/devicemapper
- docker/
- kubelet/pods
- openshift.local.volumes
noに設定します。
例:/host/homeマウント ポイントは非表示にできますが、storage_outofbox_filter_enabledフィルタでリストされているすべてのマウント ポイントを含めることができます。これを行うには、YML ファイルの環境変数セクションに環境変数を追加します。environment: - agentManager_url_1=[AGENT_MANAGER_URL] - containerflow=enabled - interval=90 - type=Docker - storage_mount_filter=/host/home - storage_outofbox_filter_enabled=no - (オプション)以下の環境変数を使用して、インフラストラクチャ エージェントが実行される JVM のxmsおよびxmxパラメータを設定できます。
- MIN_HEAP_VAL_IN_MBデフォルト:256
- MAX_HEAP_VAL_IN_MBデフォルト:512
例:YML ファイルを使用して Java ヒープの値を更新します。environment: - agentManager_url_1=[AGENT_MANAGER_URL] - containerflow=enabled - interval=90 - type=Docker - MIN_HEAP_VAL_IN_MB=335 - MAX_HEAP_VAL_IN_MB=670
Docker モニタリングのエージェント プロパティの使用
エイリアス プロパティ | プロパティの説明 | デフォルト値 |
docker.interval.seconds 間隔 com.ca.apm.docker.monitor.polling.interval | データ収集のレポート間隔を設定します。 | 120 秒 |
type monitoring.type com.ca.apm.docker.monitor.type | モニタリング タイプを示します。 | DockerMonitor |
containerflow com.ca.apm.docker.monitor.containerflow | Containerflow モジュールが有効か無効かどうかを示します。 | enabled |
docker.skip.stopped.container com.ca.apm.docker.monitor.skip.stopped.container | 停止しているコンテナのモニタリングをスキップします。 | false |
| メトリック ツリーに表示される Swarm Tasks または Docker Project Service インスタンスの最大数を設定します。設定された最大値を超えるインスタンスは、メトリック ツリーの[TaskDefault]ノードの下に表示されます。 | デフォルト: 5 |
Kubernetes ノード上のコンテナの監視
以下の手順に従います。
- DX SaaSで、[エージェント]を選択し、[エージェントのダウンロード]を選択します。
- [Docker Monitor EE2.xUCP 3.x Monitor]を選択します。
- エージェントを選択した後に表示されるインストール手順に従います。
- UCP Web サイトからクライアント バンドルをダウンロードし、バンドルを抽出したことを確認します。
- 設定コマンドで指定するノード上にkube.ymlファイルの完全パスをコピーします。
- UCP クライアント バンドルのフル パスをpathプロパティとしてinstall.ymlファイルに追加して、ファイルを保存します。このパスは、ノード セレクタ上のkube.ymlファイルを指している必要があります。
- (オプション) YML ファイルで指定されている環境変数に加えて、インフラストラクチャ エージェント プロファイル内のプロパティを使用して環境を設定します。インフラストラクチャ エージェントのプロパティの詳細については、「インフラストラクチャ エージェント プロパティ リファレンス」を参照してください。インフラストラクチャ エージェント プロパティを環境変数としてinstall.ymlファイルに渡すには、environmentセクションの最後に変数を追加します。YML 形式では、プロパティ名に区切り文字「.」は使用できません。プロパティ名のドットをアンダースコアに置き換える必要があります。たとえば、エージェント名およびプロキシ サーバを設定するには、introscope.agent.agentNameおよびintroscope.agent.enterprisemanager.transport.http.proxy.hostプロパティを以下のように使用します。env: - name: containerflow value: enabled - name: agentManager_url_1 value: [AGENT_MANAGER_URL] - name: agentManager_credential value: [AGENTMANAGER_CREDENTIAL] - name: type value: Kubernetes - name: interval value: "30" - name: KUEBRNETES_NODE_MONITORING value: "true" - name: introscope_agent_agentName value: KubernetesNodeMonitor
- (オプション)ホスト モニタをインストールすると、コンポーネント ビュー内のホスト関連情報にはStorageNameメトリックが含まれます。UNIX または Linux システムでは、ストレージ フィルタを設定して、このメトリックに関連付けられているように表示されるマウント ポイントを設定できます。ストレージ フィルタを設定するには、以下の環境変数を使用します。
- storage_mount_filterStorageNameメトリックの考慮対象から削除するマウント ポイントを指定するための変数。1 行に 1 つのマウント ポイント、または 1 行に複数のマウント ポイントをカンマで区切って指定できます。
- storage_outofbox_filter_enabled有効にされている場合、以下のマウントを除外する標準装備のフィルタ。
- devicemapper/mnt
- docker/containers
- docker/devicemapper
- docker/
- kubelet/pods
- openshift.local.volumes
このフィルタはデフォルトで有効です。無効にするには、その値をnoに設定します。
例:/host/homeマウント ポイントは非表示にしますが、storage_outofbox_filter_enabledフィルタでリストされているすべてのマウント ポイントを含めて、標準装備のフィルタを無効化します。このタスクを行うには、以下のように YML ファイルの最初の環境変数セクションに環境変数を追加します。env: - name: containerflow value: enabled - name: agentManager_url_1 value: [AGENTMANAGER_URL] - name: type value: Kubernetes - name: interval value: "120" - name: storage_mount_filter value: "/host/home" - name: storage_outofbox_filter_enabled value: "no" - (オプション)以下の環境変数を使用して、インフラストラクチャ エージェントが実行される JVM のxmsおよびxmxパラメータを設定できます。
- MIN_HEAP_VAL_IN_MB デフォルト:256
- MAX_HEAP_VAL_IN_MB デフォルト:512
例:YML ファイルを使用して Java ヒープの値を更新できます。env: - name: containerflow value: enabled - name: agentManager_url_1 value: [AGENTMANAGER_URL] - name: type value: Kubernetes - name: HostMonitoring value: disabled - name: interval value: "120" - name: MIN_HEAP_VAL_IN_MB value: "335" - name: MAX_HEAP_VAL_IN_MB value: "670"
Kubernetes モニタリングのエージェント プロパティの使用
エイリアス プロパティ | 説明 | デフォルト値 |
docker.interval.seconds 間隔 com.ca.apm.kubernetes.monitor.polling.interval | データ収集のレポート間隔を設定します。 |
|
type monitoring.type com.ca.apm.docker.monitor.type | モニタリング タイプを設定します。 | DockerMonitor |
containerflow com.ca.apm.docker.monitor.containerflow | Containerflow モジュールが有効か無効かどうかを示します。 |
|
connectionurl KUBERNETES_CONNECTION_URL com.ca.apm.kubernetes.monitor.connection.url | Kubernetes クライアントの接続 URL を示します。 | 空の文字列値 |
apitoken com.ca.apm.kubernetes.monitor.api.token | Kubernetes クラスタに接続するために必要な API トークンを示します。 | 空の文字列値 |
k8s_username com.ca.apm.kubernetes.monitor.username | クラスタ アクセス用の Kubernetes ユーザ名を示します。 | 空の文字列値 |
SHOW_METRICS_LEVEL com.ca.apm.show.metrics.level | Kubernetes モニタリング用のメトリック レベルを示します。 設定可能な値: full または minimum |
|
| メトリック ツリーに表示されるインスタンスの最大数を設定します。設定された最大値を超えるインスタンスは、メトリック ツリーの[InstanceDefault]ノードの下に表示されます。 | デフォルト: 5 |
- SHOW_METRICS_LEVEL がfullに設定されている場合、またはReadyStateが1に設定されている場合、以下のメトリックが表示されます:ClusterMonitor、Container State、Containers Per Pod、およびTotal Containers Ready。
- SHOW_METRICS_LEVEL が full に設定されている場合、またはDeployment Healthが1に設定されている場合、以下のメトリックが表示されます:ReadyState、Available Replicas、Desired Replicas、およびUptoDate Replicas。これらのメトリックの詳細については、「Kubernetes モニタリング メトリック」を参照してください。
混在ノード上のコンテナの監視
Kubernetes で実行されているポッドのパフォーマンスを測定するには、Kubernetes Monitor をインストールします。ホスト モニタリング ソリューションの重複インストールを回避するには、Docker モニタで追加の環境変数を渡します。環境変数の追加により、Docker Monitor インストールの一部としてホスト モニタをインストールすることがなくなります。
以下の手順に従います。
- DX SaaSで、[エージェント]を選択し、[エージェントのダウンロード]を選択します。
- [Docker Monitor EE2.x UCP 3.x Monitor]を選択します。
- エージェントを選択した後に表示されるインストール手順に従います。
- Docker Monitorの YML ファイルのenvという見出しの下に、以下の変数を追加します。- HostMonitoring=disabledこの変数により、インストールの重複がなくなります。