インスタナの設定

Instanaエージェント

stanctl agent コマンドを使用して、テクノロジースタックを監視する Instana エージェントをインストールします。

注意: デフォルトでは、エージェントのインストール時にランダムに生成されたエージェント・キーが使用されます。 カスタム・エージェント・キーを設定するには、 stanctl agent apply --agent-key <key-value> コマンドを使用します。

セルフ・モニタリングの有効化

ホストエージェントをインストールすることで、 Self-Hosted Standard Edition ホストの 自己監視を有効にできます。

同じバックエンドでのセルフモニタリングは、テストインストールにのみお勧めします。 信頼性の高い自己監視を行うには、理想的には2つ目のバックエンドを使用する。 2つ目のバックエンドホストでは、 demo インストールタイプを使用すれば十分です。 監視するシステム上で、 --agent-endpoint-host フラグを使用してエージェントにエージェントのアクセプターエンドポイントを割り当てる必要があります。

エージェントのアクセプタエンドポイント URL は、 Instana UI > エージェントのインストール > ページで確認できます。 <Platform> ページにあります。 agent-acceptor で始まる終点の値を探します。 詳細については、 Kubernetes のホストエージェントのインストールを参照してください。

ホストのコマンドラインインターフェイスから、以下のコマンドを実行してエージェントをインストールするか、エージェント構成を更新します:

  • セルフ・モニタリングに同じバックエンドを使用している場合は、以下のコマンドを実行する:
    stanctl agent apply
     
  • セルフ・モニタリングにセカンド・バックエンドを使用している場合は、以下のコマンドを実行する:
    stanctl agent apply --agent-endpoint-host <endpoint-of-the-second-backend> --agent-key <agent-key-of-the-second-backend> --agent-cluster-name <your-custom-local-cluster-name> --agent-zone-name <your-custom-local-cluster-zone-name>
     
注: 2番目のバックエンドがデフォルトの8600エージェント・ポートでリッスンしていない場合は、前のコマンドで --agent-endpoint-port <custom-endpoint-port-of-the-second-backend> フラグを使用してカスタム・エンドポイント・ポートを指定する。
注: stanctl コマンドがユーザー名とパスワードの入力を求めるプロンプトを表示する場合、ユーザー名にはデフォルトのユーザー _ を、パスワードにはダウンロード・キーを使用してください。

セルフモニタリングの無効化

Instana ホストエージェントをアンインストールして自己監視を停止するには、次のコマンドを実行します:

stanctl agent delete
 

Instanaバックエンドの設定

Instana バックエンドのインストール中またはインストール後いつでも、 stanctl backend apply コマンドを使用して Instana Core 設定値を更新できます。 コンフィギュレーション・オプションを見るには、 stanctl backend apply --help環境変数で説明したように、 .env ファイルを作成することもできます。

.env ファイルを使用して instana を設定するには、次のコマンドを実行します:

stanctl backend apply --env-file <your_env_file>
 

コア仕様の詳細については、 APIリファレンスの CoreSpec

Standard Edition を単一ドメインで設定する

注: 設定できるのは Standard Edition1.9.0 のみ設定できます。

単一ドメインで Standard Edition を単一ドメインでインストールし設定するには、以下のコマンドを実行する:

stanctl backend apply --core-use-tu-url-path \
   --core-acceptors-agent-port=<desired-acceptor-port> \
   --core-acceptors-otlp-http-port=<desired-otlp-http-port> \
   --core-acceptors-otlp-grpc-port=<desired-otlp-grpc-port> \
   --core-acceptors-eum-port=<desired-eum-port> \
   --core-acceptors-synthetics-port=<desired-synthetics-port> \
   --core-acceptors-serverless-port=<desired-serverless-port>
 
注: ホストとポートは、アクセプタごとに個別に設定できます。 例えば、EUMポートだけを希望のポートに設定し、他のポートは443でリッスンさせることもできる。

この設定により、UI、API、およびすべてのアクセプター・トラフィックにベース・ドメインが使用されるようになる。 制限によりサブドメインを使用できない場合に便利です。

既存の証明書の使用

カスタムのトランスポート・レイヤー・セキュリティ(TLS)証明書と鍵を使用するには、以下のコマンドを使用する:

stanctl backend apply --core-tls-crt <full-path-to-certificate-file> --core-tls-key <full-path-to-key-file>
 

サービスプロバイダの設定

注: SAML や OIDC などのサービス・プロバイダを構成するには、証明書が必要です。 証明書と鍵を組み合わせたPEMファイルを作成していることを確認する。 詳細については、 IdP 構成用のサービス・プロバイダー・キーと証明書の作成を参照してください。

サービス・プロバイダーを設定するには、以下のコマンドを実行する:

stanctl backend apply --core-service-provider-password <pem-password> --core-service-provider-pem <full-path-to-combined-pem-file>
 

プロキシー・サーバーの使用

メールサーバーやアラートチャンネルの受信者などの一部の外部サービスは、プロキシサーバーを経由しないとアクセスできない。 Instana バックエンドがこれらのサービスにアクセスするには、プロキシサーバーを設定する必要があります。 以下のコマンドを使用します。

stanctl backend apply --core-proxy-host <proxy-host> --core-proxy-port <proxy-port> --core-proxy-user <proxy-user> --core-proxy-password <proxy-password>
 

SMTPメールサーバーの使用

バックエンドの全てのメール機能を使用するには、SMPTメールサーバを設定します。

stanctl backend apply --core-smtp-check-server-identity=true --core-smtp-use-ssl=true --core-smtp-start-tls=false --core-smtp-from <sender-email-address> --core-smtp-host <SMTP-host> --core-smtp-port <SMTP-port> --core-smtp-user <SMTP-username> --core-smtp-password <SMTP-password>
 

カスタムCA証明書の使用

外部サービスの中には、カスタム認証局(CA)によって署名された証明書を使用するものがある。 これらのサービスを Instana で使用するには、その証明書をトラストストアに追加します。 これらの証明書がルート CA からのものでない場合、Instana は完全な証明書チェーン (お客様の証明書、仲介証明書、ルート証明書) をオペレーター JVM キーストアにインポートします。

stanctl backend apply --core-custom-ca-crt <ca-certificate-file>
 

水平ポッド自動スケーリング (HPA)

Instana バックエンドコンポーネントは、 Kubernetes Horizontal Pod Autoscaling (HPA) を使用して自動スケーリングをサポートします。 この機能はデフォルトで有効になっており、ワークロードの需要に基づいてポッドをスケーリングすることで、リソースの使用を最適化するのに役立つ。

HPAを明示的に無効化または再有効化したい場合は、以下のフラグを使用する:

stanctl backend apply --core-enable-hpa=<true|false>
 

オプション・フィーチャー

セルフホスト型のバックエンドでは、デフォルトでは有効にならない機能もあります。 このような機能は、追加の設定オプションを使用して有効にすることができます。

オプション機能とその有効化方法の詳細については、 オプション機能を有効にするを参照してください。

システムの再始動

オン Standard Edition に設定すると、 Kubernetes クラスタのグレースフル・シャットダウンを開始できます。 これにより、システムコンポーネントとワークロードがきれいに終了し、データの損失や破損を防ぐことができる。

注: クラスターを正しくシャットダウンするには、 reboot コマンドではなく、 systemctl reboot コマンドを実行してください。