独自のチャートを作成したり、 クエリ すべての Kubernetesインテグレーション データをクエリビルダやNerdGraph APIを使って照会することができます。当社の統合では、コンテナ・オーケストレーション・レイヤーをインスツルメンテーションすることでKubernetesのデータを収集します。よりシンプルで視覚的な体験をするには、 クラスタエクスプローラ を使用してください。
one.newrelic.com > ダッシュボード: クエリビルダー を使用して、Kubernetes のデータを照会し、わかりやすい視覚化を行うことができます。
Kubernetesのデータを照会する
Kubernetesのデータを照会する最も簡単な方法 は、 クエリビルダー を使用し、 NRQLクエリ を受け入れます。または、 NerdGraph API を使用してKubernetesデータを取得することもできます。
イベントの種類
Kubernetesのデータは、以下の イベントタイプに添付されています。:
イベント名 | Kubernetesのデータの種類 | 発売日 |
|---|---|---|
| v1.0.0 | |
| v1.0.0 | |
| v1.0.0 | |
| v1.0.0 | |
| v1.13.0 | |
| v1.13.0 | |
| v1.0.0 | |
| v1.0.0 | |
| v1.0.0 | |
| v1.0.0 | |
| v1.11.0 | |
| v1.11.0 | |
| v1.11.0 | |
| v1.11.0 | |
| v1.13.0 | |
| v1.13.0 | |
| v2.3.0 |
アラートの管理
Kubernetesのデータのアラート違反を通知することができます。
Kubernetesの属性とメトリクス
Kubernetesインテグレーションは、以下のメトリクスやその他の 属性を収集します。.
ノードデータ
K8sNodeSample イベントにノードデータを問い合わせます。
ノード属性 | 説明 |
|---|---|
| ノードに割り当てられるCPUコア数 |
| ノードの割り当て可能なメモリバイト |
| ノード割り当て可能なポッド |
| ノードに割り当てられるエフェメラルストレージのバイト数 |
| ノードのCPU容量 |
| ノードのメモリ容量（単位：バイト） |
| ノードのポッド容量 |
| ノードのエフェメラルストレージ容量 |
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| 現在観測されているノード状態のステータス。報告される条件は、Kubernetesのフレーバーやインストールされているオペレータによって異なる場合があります。 |
| ノードのCPU使用率をコアミリ秒で計測 |
| ノードのCPU使用率（コア数）を計測 |
| 要求されたCPUコアの総量 |
| 割り当て可能なCPUコア数に対する実際に使用されたCPUコア数の割合 |
| ノードのファイルシステムで利用可能なバイト数 |
| ノードファイルシステムの総容量（単位：バイト |
| ノードファイルシステム内のinodeの合計数 |
| ノードファイルシステム内の空きinode |
| ノードファイルシステムで使用されるinode |
| ノードファイルシステムの使用バイト数 |
| ノードファイルシステムの容量に対する使用バイト数の割合 |
| ノードで利用可能なメモリのバイト数 |
| ノードにおける毎秒のメジャーページフォールトの数 |
| ノード内のページフォルトの数 |
| バイトのrssメモリ |
| 使用したメモリのバイト数 |
| ワーキングセットのメモリのバイト数 |
| 要求されたメモリの総量 |
| ノードのアロカブルメモリに対するワーキングセットのメモリのバイト数の割合 |
| ネットワークでの受信／送信時に発生する1秒あたりのエラー数 |
| ポッドが動作しているホスト名 |
| コンテナのランタイムファイルシステムで利用可能なバイト数 |
| コンテナのランタイムファイルシステムに割り当てられた総容量（単位：バイト |
| コンテナのランタイムファイルシステムにおけるinodeの合計数 |
| コンテナ・ランタイム・ファイルシステムの空きinode |
| コンテナランタイムのファイルシステムで使用されるinode |
| コンテナのランタイムファイルシステムの使用バイト数 |
| 新規ポッドのノードスケジューリング可能性のステータス。値は0(false)または1(true)です。 |
| ノードに関連付けられたラベルで、特定のノードのフィルタリングやクエリーが可能 |
名前空間データ
K8sNamespaceSample イベントに名前空間データを問い合わせます。
名前空間属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| ネームスペースが作成されたときのタイムスタンプ |
| 識別子として使用される名前空間の名前 |
| ネームスペースに関連付けられたラベルで、特定のネームスペースをフィルタリングして検索可能 |
| ネームスペースの現在の状態。 値としては、 |
デプロイメントデータ
K8sDeploymentSample イベントにデプロイメントデータを問い合わせます。
デプロイメント属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| デプロイメントが作成された時のタイムスタンプ |
| 識別子として使用されるデプロイメントの名前 |
| デプロイメントが属するネームスペースの名前 |
| デプロイメントに関連付けられたラベル。特定のデプロイメントをフィルタリングして検索することができます。 |
| 現在利用可能なレプリカの数 |
| デプロイメントで定義したレプリカの数 |
| 現在稼働しているレプリカの合計数 |
| 現在利用できないレプリカの数 |
| 配置の望ましい状態を達成するために更新されたレプリカの数 |
| 不足しているレプリカの総数（希望するレプリカの数（podsDesired）からレプリカの総数（podsTotal）を差し引いた数 |
レプリカセットデータ
K8sReplicasetSample イベントに ReplicaSet データを問い合わせます。
レプリカ属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
|
|
| 識別子として使用されるデプロイメントの名前 |
|
|
|
|
| デプロイメントで定義したレプリカの数 |
|
|
| この |
| 現在稼働しているレプリカの合計数 |
| 現在不足しているレプリカの総数（希望するレプリカの数（podsDesired）から準備ができているレプリカの数（podsReady）を差し引いたもの）。 |
| 識別子として使用される |
デーモンセットデータ
K8sDaemonsetSample イベントに DaemonSet データを問い合わせます。
DaemonSet属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
|
|
|
|
| ラベルは |
daemonsetName |
|
| デーモンポッドを動作させるノードの数 |
| 少なくとも1つのデーモン・ポッドを実行しているノードの数で、次のことが想定されます。 |
| デーモンポッドを稼働させ、1つ以上のデーモンポッドが稼働して利用可能なノードの数 |
| デーモンポッドを稼働させ、1つ以上のデーモンポッドを稼働させて準備を整えておくべきノードの数 |
| デーモンポッドが稼働しているはずのノードのうち、デーモンポッドが1つも稼働しておらず、利用可能なノードの数 |
| デーモンポッドを実行しているが、想定されていないノードの数です。 |
| 更新されたデーモン・ポッドを実行しているノードの合計数 |
| 現在不足しているレプリカの総数（希望するレプリカの数（podsDesired）から準備ができているレプリカの数（podsReady）を差し引いたもの）。 |
| 希望する状態の特定の世代を表すシーケンス番号 |
StatefulSetデータ
K8sStatefulsetSample イベントに StatefulSet データを問い合わせます。
StatefulSet属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 現在不足しているレプリカの総数（希望するレプリカの数（podsDesired）から準備ができているレプリカの数（podsReady）を差し引いたもの）。 |
|
|
|
|
|
|
| シーケンス内のポッドを生成するために使用される |
ポッドデータ
K8sPodSample イベントにポッドデータを問い合わせます。
ポッド属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| ポッドが作成された時のタイムスタンプ（エポック秒）。 |
| ポッドを作成したKubernetesオブジェクトの名前。 例えば、 |
| ポッドを作成したKubernetesのオブジェクトの種類。 例えば、 |
| 識別子として使用されるデプロイメントの名前 |
| ポッドがリクエストを処理する準備ができているかどうかを表すブール値 |
| ポッドがノード上で実行されるようにスケジュールされているかどうかを表すブール値 |
| ポッドに関連付けられたラベルで、特定のポッドをフィルタリングして照会できる |
| 前回のポッドステータス変更に関する詳細 |
| ポッドが所属するネームスペースの名前 |
| ネットワークでの受信／送信時に発生する1秒あたりのエラー数 |
| 1秒あたりのエラー数 |
| ネットワーク上で受信した毎秒のバイト数 |
| ネットワーク上で送信される1秒あたりのバイト数 |
| ポッドが動作しているホストのIPアドレス |
| ポッドが動作しているホスト名 |
| ポッドのIPアドレス。IPを持っていない場合は、空になります。 |
| 識別子として使用されるポッドの名前 |
| ポッドが現在の状態になった理由 |
| ポッドの実行開始時のタイムスタンプ（単位：エポック秒 |
| ポッドの現在の状態。 Value can be |
クラスターデータ
K8sClusterSample イベントに問い合わせて、クラスターデータを見ることができます。
クラスター属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| クラスタが稼働しているKubernetesのバージョン |
コンテナデータ
K8sContainerSample イベントにコンテナデータを問い合わせます。
コンテナ属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| コンテナに関連付けられた一意のID。Dockerを使用している場合、これはDockerコンテナのIDです。 |
| コンテナが動作しているイメージの名前 |
| コンテナが動作しているイメージに関連付けられた一意のID |
| コンテナに関連する名前 |
| ポッド仕様でコンテナに定義されているCPUコア数の上限を示す整数値。 |
| ポッド仕様でコンテナに定義されている要求されたCPUコア |
| コンテナが実際に使用するCPUコア数 |
| 指定されたCPU制限に対する、コンテナが実際に使用しているCPUコアの割合。この割合は以下の計算に基づいています： ( |
| 指定されたCPUリクエストに対して、コンテナが実際に使用したCPUコアの割合 |
| 識別子として使用されるデプロイメントの名前 |
| ブール値。コンテナのレディネスチェックが成功したかどうか |
| コンテナに関連付けられたラベルで、特定のコンテナをフィルタリングしたり、クエリしたりできます。 |
| ポッド仕様でコンテナに定義されているメモリの限界バイトを表す整数値 |
| 整数です。ポッド仕様でコンテナに定義されたメモリの要求バイト数 |
| 整数です。コンテナが実際に使用しているメモリのバイト数 |
| 指定されたメモリ制限に対する、コンテナが実際に使用したメモリの割合 |
| 指定されたメモリ要求に対して、コンテナが実際に使用したメモリの割合 |
| 整数です。ワーキングセットのメモリのバイト数 |
| コンテナが実際に使用しているワーキングセットメモリの、指定されたメモリ制限に対する割合 |
| 指定されたメモリ要求に対して、コンテナが実際に使用したワーキングセットメモリの割合 |
| コンテナが所属する名前空間の名前 |
| コンテナが動作しているホストのIPアドレス |
| コンテナが稼働しているホスト名 |
| 識別子として使用される、コンテナが入っているポッドの名前 |
| コンテナが現在の状態になっている理由を提供する |
| コンテナが再起動された回数 |
| コンテナの現在の状態。 値は |
| エンフォースメント期間の経過間隔のデルタ変更 |
| 絞り込み期間の間隔のデルタ変化 |
| コンテナがスロットルされた時間のデルタ変化（単位：秒 |
| 執行猶予期間の総延長数 |
| 絞り込み期間のインターバル数の合計 |
| コンテナがスロットルされた時間の合計（秒 |
| このコンテナで使用されているメモリマップドファイルの合計サイズ（単位：バイト |
ボリュームデータ
K8sVolumeSample イベントにボリュームデータを問い合わせます。
ボリューム属性 | 説明 |
|---|---|
| 作成時にボリュームに割り当てた名前 |
| ボリュームが設定されているクラスタ |
| ボリュームを構成するネームスペース |
| ボリュームがアタッチされているポッドです。Kubernetes monitoring integrationでは、ポッドにアタッチされているボリュームをリストアップしています。 |
| これが persistent ボリュームの場合、この値は |
| Persistent Volume Claimが設定されている名前空間 |
| 作成時にPersistent Volume Claimに割り当てた名前 |
| ボリュームの容量（単位：バイト |
| ボリュームの使用量（単位：バイト |
| ボリュームの空き容量（単位：バイト |
| ボリュームの使用率（パーセンテージ |
| 合計 |
|
|
|
|
ボリュームデータは、MetricsProviderインターフェースを実装したボリュームプラグインで利用できます。
- AWSElasticBlockStore
- AzureDisk
- AzureFile
- シンダー
- フレックスボリューム
- フロッカ
- GCEPersistentDisk
- GlusterFS
- iSCSI
- NFS
- StorageOS
- VSphereVolume
APIサーバーデータ
K8sApiServerSample イベント を照会して、APIサーバーのデータを確認します。詳細については、 Configure control plane monitoring を参照してください。
APIサーバー属性 | 説明 |
|---|---|
| レジデント・メモリ・サイズ、バイト単位 |
| ユーザーとシステムのCPU使用時間の差（単位：秒 |
| 作成されたOSスレッドの数 |
| 現在存在するゴルーチンの数 |
| apiserverのリクエスト数の差、動詞とHTTPレスポンスコードごとの内訳 |
| apiserverリクエストの割合（動詞およびHTTPレスポンスコードごとに集計 |
| メソッドとコードに分けたHTTPリクエスト数の差 |
| HTTPリクエスト数の割合（メソッドとコード別に分割 |
| 前回のチェック時に保管されていたオブジェクトの数（種類別に分割 |
コントローラー・マネージャー・データ
K8sControllerManagerSample イベントに問い合わせて、コントローラマネージャのデータを確認します。詳細については、 コントロールプレーン監視の設定 を参照してください。
コントローラーマネージャー属性 | 説明 |
|---|---|
| レジデント・メモリ・サイズ、バイト単位 |
| ユーザーとシステムのCPU使用時間の差（単位：秒 |
| 作成されたOSスレッドの数 |
| 現在存在するゴルーチンの数 |
| ワークキューが処理した総アドの数の差 |
| ワークキューの現在の深さ |
| ワークキューが処理した再試行回数の合計値の差 |
| 報告システムが関連するリースのマスターであるかどうかのゲージ。 |
スケジューラーデータ
K8sSchedulerSample イベントを問い合わせて、Schedulerデータを確認します。詳細については、 Configure control plane monitoring を参照してください。
スケジューラ属性 | 説明 |
|---|---|
| レジデント・メモリ・サイズ、バイト単位 |
| ユーザーとシステムのCPU使用時間の差（単位：秒 |
| 作成されたOSスレッドの数 |
| 現在存在するゴルーチンの数 |
| 報告システムが関連するリースのマスターであるかどうかのゲージ。 |
| 分位値ごとの、マイクロ秒単位のHTTPリクエストレイテンシー |
| HTTPリクエストのレイテンシーの合計値（単位：マイクロ秒 |
| 観測されたHTTPリクエストイベントの数 |
| ステータスコード、メソッド、ホストごとに分けられたHTTPリクエスト数の差 |
| ステータスコード、メソッド、ホストごとに分けられたHTTPリクエスト数の割合 |
| ポッドのスケジューリングを試みた回数と、その結果の差。 |
| ポッドのスケジューリングを試みた回数を結果別に表したレート。 |
| スケジューリング操作のサブパートごとに分割された秒単位のスケジューリングレイテンシー |
| スケジューリング操作のサブパートごとに分割されたスケジューリングレイテンシーの合計（秒単位 |
| スケジューリング操作のサブパートで分割されたスケジューリングの観測されたイベントの数。 |
| クラスタにおける現在までのプリエンプション試行回数の差 |
| 選択された先取り被害者の数 |
etcdデータ
K8sEtcdSample event に問い合わせて、etcdデータを確認します。詳細については、 Configure control plane monitoring を参照してください。
etcd属性 | 説明 |
|---|---|
| レジデント・メモリ・サイズ、バイト単位 |
| ユーザーとシステムのCPU使用時間の差（単位：秒 |
| 作成されたOSスレッドの数 |
| 現在存在するゴルーチンの数 |
| リーダーが存在するかどうか |
| リーダー交代回数の違い |
| 物理的に割り当てられている基礎となるデータベースの総サイズ（単位：バイト |
| コミットされたコンセンサス案の総数の差 |
| コミットされたコンセンサス・プロポーザルの総数の割合 |
| 適用されたコンセンサス案の総数の差 |
| 応募されたコンセンサス案の総数に対する割合 |
| コミットするための現在のペンディング・プロポーザルの数 |
| 失敗した提案の総数の差 |
| 失敗したプロポーザルを見た回数の割合 |
| 開いているファイル記述子の数 |
| 開いているファイル記述子の最大数 |
| オープン可能な最大数に対する、オープンしているファイルディスクリプターの割合 |
| gRPCクライアントから受信した総バイト数の割合 |
| gRPCクライアントに送信される総バイト数の割合 |
エンドポイントデータ
K8sEndpointSample イベントにエンドポイントデータを問い合わせます。
エンドポイント属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| エンドポイントが作成された時のタイムスタンプ |
| エンドポイントが所属するネームスペースの名前 |
| エンドポイントに関連する名前 |
| エンドポイントに関連付けられたラベルで、特定のエンドポイントのフィルタリングやクエリーが可能 |
| エンドポイントで利用可能なアドレス数 |
| エンドポイントの準備ができていないアドレス数 |
サービスデータ
K8sServiceSample イベント にサービスデータを問い合わせます。
サービス属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| サービスが作成された時のタイムスタンプ |
| サービスが所属するネームスペースの名前 |
| サービスに関連付けられたラベルで、特定のサービスをフィルタリングして照会することができます。 |
| サービスに関連する名前 |
|
|
|
|
|
|
| サービスの種類 |
| 本サービスが対象とするラベルセレクター |
Horizontal Pod Autoscaler データ
K8sHpaSample イベントでHorizontal Pod Autoscalerのデータを照会します。
HPA属性 | 説明 |
|---|---|
| Kubernetesインテグレーションのインストール時にクラスタに割り当てた名前 |
| HPAに関連付けられたラベルで、特定のオートスケーラーをフィルタリングして照会することができます。 |
| このオートスケーラーが管理するポッドの現在のレプリカ数 |
| このオートスケーラーが管理するポッドのレプリカの希望数 |
| オートスケーラーで設定可能なポッド数の下限値、デフォルトでは1 |
| オートスケーラーで設定できるポッドの数の上限。 |
| このオートスケーラーが希望するレプリカ数を計算する際に使用するメトリックの仕様です。 |
| オートスケーラーがスケールを取得・更新できるかどうか、また、バックオフに関連する条件でスケーリングができないかどうかを表すブール値 |
| オートスケーラーが有効であるかどうか（目的のスケールを計算できるかどうか）を表すブール値。 |
| オートスケーラーが、設定された最大または最小のレプリカによって上下にキャップされているかどうかを表すブール値 |
| Prometheusのラベルに変換されたKubernetesのラベルの数 |
| HorizontalPodAutoscalerコントローラで観測される世代 |
APMが監視するアプリケーションにおけるKubernetesのメタデータ
アプリケーションをKubernetesと連携させることで 、アプリケーショントレースや分散トレースに以下の属性が追加されます。
ノード名コンテナ名ポッドネームclusterNameデプロイメント名名前空間名