Windows でのインストレーション

Windows ベースの Kubernetes システムを使用している場合は、このオプションを使用します。 Windows インテグレーションにはいくつかの制限があることに注意してください。

互換性と要件

Kubernetes 統合をインストールする前に、 互換性と要件を確認してください。

Windows のバージョンを確認するには、コマンド ウィンドウを開いて、次のコマンドを実行します。

$
Reg Query "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion" /v
$
ReleaseIdcmd.exe

WindowsにKubernetesをインストールする

Windows用のKubernetesインテグレーションは、Helmを使ってインストールできます。Windowsの異なるビルドバージョン（1809と2004）を持つノードを持つクラスタに統合をインストールする方法の例を参照してください。

$
helm repo add newrelic https://helm-charts.newrelic.com

$
kubectl create namespace newrelic

$
helm repo add ksm https://kubernetes.github.io/kube-state-metrics
$
helm install ksm ksm/kube-state-metrics --version 2.13.2

global:
      licenseKey: _YOUR_NEW_RELIC_LICENSE_KEY_
      cluster: _K8S_CLUSTER_NAME_

    enableLinux: true        # Set to true if your cluster also has linux nodes
    enableWindows: true
    windowsOsList:
      - version: 2019            # Human-readable version identifier
        imageTag: 2-windows-1809-alpha  # Tag to be used for nodes running the windows version above
        buildNumber: 10.0.17763         # Build number for your nodes running the version above. Used as a selector.
      - version: 20h2
        imageTag: 2-windows-20H2-alpha
        buildNumber: 10.0.19042
      - version: 2022
        imageTag: 2-windows-ltsc2022-alpha
        buildNumber: 10.0.20348
    nodeSelector:
      kubernetes.io/os: linux         # Selector for Linux installation.
    windowsNodeSelector:
      kubernetes.io/os: windows       # Selector for Windows installation.

$
helm upgrade --install newrelic newrelic/newrelic-infrastructure \
>
    --namespace newrelic --create-namespace \
>
    --version 2.7.2 \
>
    -f values-newrelic.yaml

$
kubectl -n newrelic get pods -w

例: BusyBox コンテナーから Kubernetes for Windows を取得する

これは、BusyBox コンテナーから Kubernetes for Windows を取得する方法の例です。

以下のコマンドを実行します。

$
kubectl exec -it busybox1-766bb4d6cc-rmsnj -- Reg Query
$
"HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion" /v ReleaseId

このように表示されます。

$
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion
$
ReleaseId   REG_SZ  1809

リリース ID と OS バージョンの間の有用なマッピングについては、 ここを参照してください。

Windows 向けKubernetesインテグレーションの制限

Windows エージェントは、 K8sNodeSampleやK8sPodSampleなどのKubernetes サンプルのみを送信します。 Windows 用のKubernetesインテグレーションには次の制限が適用されます。

• SystemSample、 StorageSample 、 NetworkSample 、およびProcessSampleは生成されません。

• Windows kubelet には存在しないため、いくつかのKubernetesメトリクスが欠落しています。

  • ノードです。

    • fsInodes： 送信されません
    • fsInodesFree： 送信されません
    • fsInodesUsed： 送信されません
    • memoryMajorPageFaultsPerSecond: 値として常にゼロを返します
    • memoryPageFaults: 値として常にゼロを返します
    • memoryRssBytes: 値として常にゼロを返します
    • runtimeInodes： 送信されません
    • runtimeInodesFree： 送信されません
    • runtimeInodesUsed： 送信されません

  • Pod:

    • net.errorsPerSecond： 送信されません
    • net.rxBytesPerSecond： 送信されません
    • net.txBytesPerSecond： 送信されません

  • コンテナです。

    • containerID： 送信されません
    • containerImageID： 送信されません
    • memoryUsedBytes: UIでは、ポッドをクリックしたときに表示されるポッド カードにデータが表示されません。 代わりにmemoryWorkingSetBytesを使用するようにチャートを更新することで、この問題をすぐに修正する予定です。

  • 巻です。

    • fsUsedBytes: ゼロなので、 fsUsedPercentはゼロです

Windows Kubeletの既知の問題

Windows版のKubeletにはいくつかの問題があり、統合機能がデータを取得できないことがあります。

• 問題 90554:この問題により、インテグレーションが/stats/summaryトークンにリクエストを送信したときに、Kubelet が 500 エラーを返します。 これはKubernetes 1.19リリースに含まれ、リリース1.16.11にバックポートされています。 1.17.7、および 1.18.4。 この問題に対するインテグレーション側での解決策はありませんので、できるだけ早くパッチ バージョンのいずれかに更新することをお勧めします。 詳細ログを有効にして、次のタイプのメッセージを探すことで、この問題の影響を受けているかどうかを確認できます。

  bash

  コピー

  $
  error querying Kubelet. Get "https://<KUBELET_IP>/stats/summary": error calling kubelet endpoint. Got status code: 500

• 問題 87730:この問題により、最小負荷で実行しているときに Kubelet メトリックが非常に遅くなります。 タイムアウト エラーが発生して統合が失敗します。 この問題に対するパッチはKubernetes 1.18に追加され、1.15.12にバックポートされました。 1.16.9、および 1.17.5。 できるだけ早くいずれかのパッチ バージョンに更新することをお勧めします。 この問題を軽減するには、 TIMEOUT構成オプションを使用してインテグレーション タイムアウトを増やすことができます。 詳細ログを有効にして、次のタイプのメッセージを探すことで、この問題の影響を受けているかどうかを確認できます。

  bash

  コピー

  $
  error querying Kubelet. Get "https://<KUBELET_IP>/stats/summary": context deadline exceeded (Client.Timeout exceeded while awaiting headers)