IBM Concert プラットフォーム向けセルフホスト型 Standard Edition のインストール

オンラインで編集

Standard Edition をConcertプラットフォームの機能としてインストールし、設定します。

重要：エアギャップ環境でのインストールはサポートされていません。

まず、ConcertプラットフォームとConcert Observe機能を購入してください。詳細については、「 IBM Concert プラットフォーム」をご覧ください。

次に、以下のセクションの手順に従って、 Instana をインストールしてください。インストール手順には、 Standard Edition のインストール方法およびプラットフォームハブとの連携方法に関する説明が含まれています。

インストールプロセスでは、stanctl ツールを使用して Instana をデプロイします。

前提条件

作業を開始する前に、以下の前提条件を満たしていることを確認してください：

外部ディスクを備えたノード（3台または5台を推奨）を用意します。システム要件については、以下のトピックをご覧ください：
- シングルノードクラスタについては、「シングルノード展開のシステム要件」を参照してください。
- 3ノードのクラスタについては、「3ノード展開のシステム要件」を参照してください。
- 5ノードのクラスタについては、「5ノード展開のシステム要件」を参照してください。
Concertプラットフォームの機能として Instana を利用するには、機能フラグを有効にする必要があり、そのためにはCPUコアを2つ、メモリを10 GB追加する必要があります。マルチノードクラスタでは、データストアとして使用されていないノードに、これらの追加リソースを追加してください。これらは、単一のノードに追加することも、複数のノードにまたがって追加することもできます。
Instana のインストールパラメータを手元に用意しておいてください。詳細については、「開始する前に」セクションの表1および表2を参照してください。
Instana の初期管理者ユーザー用に、有効なメールアドレスを作成してください。
Concertプラットフォームハブをインストールして設定します。
注：プラットフォームハブと Instana は、別々のクラスターにインストールする必要があります。
以下のタスクをすべて完了したことを確認してください：
- プラットフォームハブをインストールし、 URL からハブにアクセスできるようになりました。
- ハブにユーザーを追加しました。
- Instana のインスタンスを、以下の形式で登録しました。 <UNIT_NAME>_<TENANT_NAME>.<BASE_DOMAIN_FOR_ENVIRONMENT>
IBM Concert をインストールした場合は、 IBM Concert というホスト名をメモしておいてください。
IBM Turbonomic をインストールした場合は、 IBM Turbonomic というホスト名をメモしておいてください。

インストール

IBM Concert プラットフォームに Standard Edition をインストールするには、以下の手順を実行してください：

stanctl1.14.1 以降のバージョンのツールをインストールしてください。

コアおよびユニットのカスタム値用のディレクトリとファイルを作成します。

mkdir -p $HOME/.stanctl/values/instana-core $HOME/.stanctl/values/instana-unit

touch $HOME/.stanctl/values/instana-core/custom-values.yaml $HOME/.stanctl/values/instana-unit/custom-values.yaml

core $HOME/.stanctl/values/instana-core/custom-values.yaml ファイルを、以下の例のような内容で設定してください：

<HUB_URL> および <HUB_PORT> を、Concert Hub 環境の外部からアクセス可能な URL およびポート番号に置き換えてください。 Instana この URL を使用してハブに接続します。
その concert/imageConfig/tag 値が、ご使用のハブのビルドバージョンと同期されていることを確認してください。
この config.saas.platform.all.origins プロパティ内の <CONCERT_access_hostname> および <TURBO_access_hostname> を、実際の Concert および Turbonomic のアクセス用ホスト名に置き換えてください。現在この情報をお持ちでない場合でも、インストール完了後ならいつでも追加することができます。詳細を追加した後は、必ずこの stanctl backend apply コマンドを実行してください。
config.solis.hub.environments プロパティでは、の unit0-tenant0 デフォルト値が使用されます。デプロイ時に別のユニット名やテナント名を指定する場合は、デフォルト値を実際のユニット名やテナント名に置き換えてください。

gatewayConfig:
  concert:
    imageConfig:
      registry: artifact-public.instana.io
      repository: self-hosted-images/k8s/ibm-solis-gw
      tag: v3.0.0
    properties:
      - name: solis.hub.external.url
        value: "https://<HUB_URL>:<HUB_PORT>"
featureFlags:
  - name: feature.beeinstana.infra.metrics.enabled
    enabled: true
  - name: feature.solis.enabled
    enabled: true
  - name: feature.vulnerabilityCenter.enabled
    enabled: true
  - name: feature.resource.optimization.actions.enabled
    enabled: true
  - name: feature.ibm.common.enabled
    enabled: true
  - name: feature.solis.test.catalog.enabled
    enabled: true
  - name: feature.tealium.privacy.enabled
    enabled: true
  - name: feature.walkme.tool.enabled
    enabled: true
  - name: feature.segment.analytics.enabled
    enabled: true
  - name: feature.solis.jwt.enabled
    enabled: true
  - name: feature.remote.integrations.enabled
    enabled: true
  - name: feature.instana.prefix.enabled
    enabled: true
  - name: feature.coordinator.ai.agent.enabled
    enabled: true
  - name: feature.coordinator.ai.agent.component.enabled
    enabled: true
  - name: feature.automated.investigation.ai.agent.enabled
    enabled: true
  - name: feature.automated.investigation.ai.agent.component.enabled
    enabled: true
  - name: feature.kubernetes.ai.agent.enabled
    enabled: true
  - name: feature.kubernetes.ai.agent.component.enabled
    enabled: true
  - name: feature.slo.ai.agent.enabled
    enabled: true
  - name: feature.slo.ai.agent.component.enabled
    enabled: true
  - name: feature.mcp.instana.component.enabled
    enabled: true
  - name: feature.incident.ai.summarization.enabled
    enabled: true
  - name: feature.instana.chat.enabled
    enabled: true
  - name: feature.ai.gateway.enabled
    enabled: true
  - name: feature.ai.rca.agentic.workflow.enabled
    enabled: true
  - name: feature.mcp.instana.enabled
    enabled: true
  - name: feature.action.ai.generation.enabled
    enabled: true
  - name: feature.graphql.endpoint.enabled
    enabled: true
  - name: feature.ai.automated.investigation.enabled
    enabled: true
  - name: feature.rca.agentic.enabled
    enabled: true
  - name: feature.rca.ai.automated.investigation.enabled
    enabled: true
properties:
  - name: config.tag.processor.readiness.min.storage.hit.rate
    value: "0.5"
  - name: config.saas.platform.iam.enabled
    value: "true"
  - name: config.saas.platform.all.origins
    value: "<CONCERT_access_hostname>,<TURBO_access_hostname>"
  - name: config.platform.hub.path
    value: "platform_hub"
  - name: config.solis.jwt.audience
    value: "PLATFORMAUD"
  - name: config.solis.jwt.issuer
    value: "IBMPLATFORM"
  - name: config.solis.hub.url
    value: "https://concert-gateway.instana-core.svc.cluster.local:20443"
  - name: config.solisUiHost
    value: "/solis_hub/ui"
  - name: config.solis.jwt.verifyInstanceUrl
    value: "false"
  - name: config.solis.hub.environments
    value: "unit0-tenant0"
  - name: config.solis.jwt.verifySubject
    value: "false"

unit $HOME/.stanctl/values/instana-unit/custom-values.yaml ファイルを、以下の例のような内容で設定してください。

<VALID_EMAIL_ADDRESS> を、初期管理者ユーザーの有効なメールアドレスに置き換えてください。

initialAdminUser: <VALID_EMAIL_ADDRESS>
properties:
  - name: config.ui.backend.server.max.request.header.size
    value: "32KiB"
  - name: config.ui.backend.server.max.response.header.size
    value: "32KiB"
  - name: config.ui.backend.websocket.max.header.size
    value: "32768"

以下の stanctl up コマンドを実行して、 Instana をデプロイし、Concert プラットフォームと連携させてください。このコマンドを実行すると、 Kubernetes クラスターがデプロイされ、Concertプラットフォームと接続されます。
- <INSTANA_SALES_KEY> を、ご自身の Instana のセールスキーに置き換えてください。
- <BASE_DOMAIN_FOR_ENVIRONMENT> を、お使いの VM のホスト名、またはConcertプラットフォームのロードバランサーのCNAMEまたはIPアドレスに対応する DNS のエントリに置き換えてください。
- <INSTANA_PASSWORD> を、ユニットカスタム値ファイルで指定した Instana 管理者ユーザーのパスワードに置き換えてください。
- --multi-node-ips マルチノードクラスタの場合は、パラメータを使用してノードのIPアドレスを追加してください。次のコマンドでは、このパラメータには 3 つの IP アドレスを指定します。 5ノードのクラスタがある場合は、IPアドレスをさらに2つ追加してください。
- シングルノードクラスタの場合、および --multi-node-ips パラメータは --multi-node-enable 不要です。
- すべてのアクセプタサービス（エージェント、 OTLP、EUM、サーバーレス、およびシンセティックス）はポート8443を使用します。必要に応じてサブドメインを設定できますが、ポート番号は443にはできません。
```
stanctl up --concert-platform-enabled \
  --instana-version=3.319.465-0 \
  --download-key=<INSTANA_DOWNLOAD_KEY> \          
  --sales-key=<INSTANA_SALES_KEY> \
  --multi-node-enable \
  --multi-node-ips <node0 IP>,<node1 IP>,<node2 IP> \ 
  --install-type production \          
  --core-base-domain=<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-agent-host=agent-acceptor.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-agent-port=8443 \
  --core-acceptors-opamp-host=opamp-acceptor.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-opamp-port=8443 \
  --core-acceptors-otlp-grpc-host=otlp-grpc.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-otlp-grpc-port=8443 \
  --core-acceptors-otlp-http-host=otlp-http.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-otlp-http-port=8443 \
  --core-acceptors-eum-port=8443 \
  --core-acceptors-serverless-port=8443 \
  --core-acceptors-synthetics-port=8443 \
  --unit-initial-admin-password=<INSTANA_PASSWORD>
```
この展開には、以下のコンポーネントが含まれます：
- Instana コアとConcertプラットフォームの統合
- Instana プラットフォーム認証機能付きユニット
- ポート8443でのエージェント、 OTLP、EUM、サーバーレス、およびシンセティックテスト向けのアクセプターサービス

検証

https://<UNIT>-<TENANT>.<BASE_DOMAIN_FOR_ENVIRONMENT>インストールを確認するには、 Instana のユーザーインターフェースにアクセスしてください。

「Unit」のカスタム値ファイルで指定した Instana の認証情報を入力してください。プラットフォームのログインページにリダイレクトされます。そこで、ハブで設定したユーザーの認証情報を入力してください。