Oracle Container Engine for Kubernetes (OKE) でのホスト・エージェントのインストール

オンラインで編集する

Kubernetes クラスターに instana-agent をインストールするには、さまざまな方法があります。エージェントを手動でホストに直接インストールすると、そのホストのコンテナーとプロセスをモニターするジョブは実行されますが、Kubernetes データは収集できなくなります。

インストール

オンラインで編集する

推奨されるエージェントのインストール方法は、 Helm チャートを使用する方法です。手動でインストールするには、通常の Kubernetes のインストール手順に従ってください。

「 Oracle Container Engine for Kubernetes （OKE）」上で Kubernetes クラスターを作成する際、 Helm をインストールするオプションが用意されています Tiller (Helm) Enabled。OKEでの Helm の使用方法の詳細については、OKEのドキュメント「 Kubernetes クラスターの作成」を参照してください。

クラスターにインストールされている Helm のバージョンと、ワークステーションにインストールされているバージョンを確認します。

helm version

新しく作成した Kubernetes クラスターにインストールされている Helm のバージョンが、ワークステーションにインストールされている Helm のバージョンより古い場合は、以下のコマンドを使用して更新します。

helm init --upgrade

「 Instana 」の helm チャートを自分のワークステーションにクローンしてください。

git clone https://github.com/instana/helm-charts

複製したディレクトリーを作業ディレクトリーにします。

cd helm-charts/stable/instana_agent

Instana ユーザー・インターフェースのサイドバーから「設定」をクリックします。 エージェントのインストールを選択し、Docker ベースのパネルから固有のエージェント・キーとエージェント・エンドポイントをメモします。次に、values.yaml を編集して、それらの値を付け加えます。

image:
  name: icr.io/instana/agent
  tag: latest
  pullPolicy: IfNotPresent

rbac:
  create: true

instana:
  zone: Oracle-OKE
  leaderElectorPort: 42655
  agent:
    key: <your unique key here>
    name: instana-agent
    endpoint:
      host: <regional endpoint here>
      port: 443

## Annotations to be added to pods
podAnnotations: {}

最後に helm を使用してインストールします。

helm install --name instana-agent --namespace instana-agent .

ホストエージェントの状態を確認する

オンラインで編集する

ホストエージェントをインストールした後、 Instana のUIまたはホスト上で、ホストエージェントのステータスを確認できます。詳しくは、ホスト・エージェントの状況の確認を参照してください。

モニター対象アプリケーションのネットワーク・アクセスの構成

オンラインで編集する

以下のタイプのアプリケーションは、最初にエージェントに接触する必要があります。

Node.js
Go
Ruby
Python
.NET Core

これらのランタイムで記述されたアプリケーションは、同じ Kubernetes ノード上でホストエージェントがどのIPアドレスでリスニングしているかを把握しておく必要があります。エージェントはホストのIPアドレスを自動的にリッスンするため、以下の Downward API スニペットを使用して、ホストエージェントのIPアドレスを環境変数としてアプリケーションポッドに渡してください：

spec:
  containers:
      env:
        - name: INSTANA_AGENT_HOST
          valueFrom:
            fieldRef:
              fieldPath: status.hostIP

エージェントの展開に関するトラブルシューティング

オンラインで編集する

最初にエージェントを正常にインストールできなかった場合は、ログ・メッセージとトラブルシューティングのヒントを確認できます。このトラブルシューティングのセクションで疑問が解決しない場合は、 IBM （ Instana ）のサポートチームまで、具体的な状況をご連絡ください。お客様をサポートするとともに、ドキュメントを適切に更新させていただきます。

すべてのホスト・エージェントに共通のトラブルシューティング情報については、「ホスト・エージェントの管理/トラブルシューティング」を参照してください。