インスタナの設定
stanctl を使用して、Instana エージェントのインストールと管理、バックエンド設定の完了、認証パラメータの更新、オプション機能の有効化を行います。
stanctl の詳細については、 stanctlコマンドの使用を参照のこと。
Instanaエージェント
stanctl agent コマンドを使用して、テクノロジースタックを監視する Instana エージェントをインストールします。
- Instana エージェントの詳細については、 Instana エージェントのインストールを参照してください。
stanctl agentコマンドの詳細については、stanctl agent --helpを参照のこと。
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>
--agent-endpoint-port <custom-endpoint-port-of-the-second-backend> フラグを使用してカスタム・エンドポイント・ポートを指定する。セルフモニタリングの無効化
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 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>
この設定により、UI、API、およびすべてのアクセプター・トラフィックにベース・ドメインが使用されるようになる。 制限によりサブドメインを使用できない場合に便利です。
既存の証明書の使用
カスタムのトランスポート・レイヤー・セキュリティ(TLS)証明書と鍵を使用するには、以下のコマンドを使用する:
stanctl backend apply --core-tls-crt <full-path-to-certificate-file> --core-tls-key <full-path-to-key-file>
サービスプロバイダの設定
サービス・プロバイダーを設定するには、以下のコマンドを実行する:
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 コマンドを実行してください。