プライベートな場所の設定

helm のインストールコマンドを使用して、新しいSynthetic PoP, をインストールし、以下の値を指定してください。 PoP は、別のネームスペースにインストールすることをお勧めします。

• ダウンロードキー: イメージを取得するためのダウンロードエージェントキーcontainers.instana.ioDockerレジストリ。
• controller.location: 形式は label; displayLabel; country; city; latitude; longitude; descriptionです。 このラベルは PoP の識別子として機能します。スペースを含まない単一の文字列でなければなりません。 ラベルには、英字、数字、ハイフン、およびアンダースコアのみを含めることができます。
• controller.instanaKey : Instana のエージェントキー。 Instana バックエンドへの接続に使用されます。
• controller.instanaSyntheticEndpoint : Instana バックエンドにおけるSyntheticアクセプターのイングリッスエンドポイント。
• コントローラー.クラスター名: オプション。 この PoP を監視するために Instana エージェントをインストールする際、 Instana UI に表示される Kubernetes クラスタの名前を設定する必要があります。
• redis.password ： redis サーバーへの認証パスワード。 10 以上の長さのパスワードを指定してください。
• redis.tls.enabled : ` Redis ` および ` TLS ` を有効にするかどうかを指定します（デフォルトは false）。 値がの場合 true、 Redis との通信は TLS で暗号化されます。
• redis.tls.secretName ：この redis.tls.enabled フィールドの値が「 true」の場合、 Redis TLS のキー/証明書ファイルに対して秘密名を指定する必要があります。 downloadKey、controller.instanaKey、controller.instanaSyntheticEndpointの値を見つけるには、以下の手順を実行します：

1. Instana のUIにサインインし、 「Synthetic Monitoring」 をクリックします。
2. 「場所」 をクリックしてください。
3. 以下のいずれかのステップを実行します。
   • Instana （ SaaS, ）で、 「場所を作成 」をクリックし、 「非公開 」を選択します。
   • Instana のセルフホスト版で、 「 PoP を展開」 をクリックし、 「プライベート」 を選択します。
4. downloadKey、controller.instanaKey、controller.instanaSyntheticEndpointの値をコピーする。

インストールを構成するには、 --set フラグを使用してコマンド・ラインで値を指定するか、 -f フラグを使用して値を指定した yaml ファイルを指定します。

以下の例では、ロケーション名 MyPoP を持つシンセティック PoP がデプロイされ、 Redis は認証にパスワードを使用します。 要件に基づいて、以下のパラメーターを更新する必要があります。

helm install synthetic-pop \
    --repo https://agents.instana.io/helm  \
    --namespace syn \
    --create-namespace \
    --set downloadKey="yourdownloadkey" \
    --set controller.location="MyPoP;My PoP;MyCounty;MyCity;0;0;This is a testing Synthetic Point of Presence" \
    --set controller.instanaKey="instanaAgentkey" \
    --set controller.instanaSyntheticEndpoint="https://synthetics-green-saas.instana.io" \
    --set redis.tls.enabled=false \
    --set redis.password="a1fc5d01bcbb" \
    synthetic-pop
 

また、 values.yaml を指定して、 PoP をデプロイすることもできます。 次の例では、 values.yaml テンプレートを取得し、変更を加えたYAMLファイルを渡して PoP をデプロイする方法を示します。

helm repo add synthetic-pop-repo https://agents.instana.io/helm
helm repo update
helm pull synthetic-pop-repo/synthetic-pop
tar xzvf synthetic-pop-*.tgz
# Modify the synthetic-pop/values.yaml file
# Run helm install to pass the modified values.yaml
 helm install synthetic-pop \
    --repo https://agents.instana.io/helm  \
    --namespace syn \
    --create-namespace \
    -f /path/to/values.yaml \
    synthetic-pop
 

PoP をインストールした後、各ポッドの状況が Running および Ready であることを確認します。

kubectl get pod -n syn
 

Instana のUIにサインインし、 「Synthetic Monitoring」 > 「Locations 」をクリックすると、ロケーション一覧に自分のロケーションが表示されていることが確認できます。 そうでない場合は、「 トラブルシューティング 」セクションに進み、ログ・ファイルを確認してください。

Synthetic PoP, 以下のセキュリティ対策を適用してください。

バックエンド移行シナリオに対応するため、セミコロンで区切って複数のSyntheticアクセプターエンドポイントと Instana エージェントキーを指定できます。 Instana エージェントキーとSyntheticのアクセプターエンドポイントは、1対1の関係にあります。 移行期間中、Synthetic PoP は、ダウンタイムを回避するために、旧バックエンドと新バックエンドの両方にデータを送信できます。

以下の例を参照してください。

helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
    --set controller.instanaKey="instanaAgentkey;anotherInstanaAgentKey" \
    --set controller.instanaSyntheticEndpoint="https://synthetics-green-saas.instana.io;https://synthetics-green-saas.instana.host" \
    ...
 

要件に応じて、一部のプレイバック・エンジンを無効にすることができます。 例えば、ブラウザー・テストが不要になった場合は、 BrowserScript 再生エンジンを無効にすることができます。 シンセティック PoPの CPU とメモリーのリソースを削減するために、以下のパラメーターを渡してプレイバック・エンジンを無効にします。

--set browserscript.enabled=false
 

のcontroller.capabilitiesプロパティは合成の再生機能を定義しますPoP,サポートされている合成テストと Web ブラウザーの種類が含まれます。

controller.customProperties プロパティーは、この PoPのカスタマイズされたタグまたはプロパティーを定義します。 このプロパティーは、 key1=value1;key2=value2のようにセミコロンで区切られた key:value のペアのリストです。

API$env.key1 やブラウザスクリプト内でカスタムプロパティやタグにアクセスするには、次のような API を使用します。

Synthetic PoP が Instana のバックエンドサーバーに接続できるよう、プロキシサーバーを設定できます。 以下のオプションがサポートされています。

• proxy.popProxyProtocol: プロキシー・サーバーによって使用されるプロトコル。 値を http または socksに設定します。
• proxy.popProxyServer: ipaddress:port 形式のプロキシー・サーバー・アドレス。
• proxy.popProxyUserPass: プロキシー・サーバーを認証するためのユーザー名とパスワード。 ユーザー名とパスワードを username:password の形式で入力します。

この設定は、セルフホスト型の Instana バックエンドとSyntheticの PoP が同じネットワーク上で実行されている場合に使用できます。 PoP コントローラーは、プロキシを経由せずにバックエンドに直接接続できます。外部エンドポイントのテストを行う際には、再生エンジンだけがプロキシ経由でアクセスする必要があります。

再生エンジンコンテナのプロキシ環境変数を設定することで、 HTTP、 JavaScript,、 BrowserScript,、ISMテストなどのシンセティックテストの送信トラフィックを、社内プロキシ経由でルーティングすることができます。 これらの設定は、合成テストの実行にのみ適用され、 PoP とバックエンド間の接続には影響しません。

サポートされている環境変数：

• HTTP_PROXY: HTTP への送信リクエスト用のプロキシサーバー
• HTTPS_PROXY: HTTPS への送信リクエスト用のプロキシサーバー
• NO_PROXY: プロキシを経由せずにアクセスする必要があるホストまたはドメイン（例： Instana のバックエンドおよび内部クラスタのドメイン）

HTTP_PROXY: "http://proxy:3128"
HTTPS_PROXY: "http://proxy:3128"
NO_PROXY: "instana.backend.example.com,.svc,.cluster.local"

Helm チャートを使用してキー controller.instanaKey、 redis.password、 proxy.popProxyUserPass、および downloadKeyの新しいシークレットを作成しない場合は、以下のようにシークレット名を指定して、シンセティック PoP デプロイメント用に作成した既存のシークレットを使用できます。

helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
    --set downloadSecret="my-pull-secret" \
    --set controller.instanaKeySecret="my-pop-secret" \
    --set redis.passwordSecret="my-pop-secret" \
    --set proxy.popProxyUserPassSecret="my-pop-secret" \
    ...
 

キー controller.instanaKey、 redis.password、および proxy.popProxyUserPassには、同じシークレットを使用することも、既存の別のシークレットを使用することもできます。 ただし、シークレットを作成する際は、指定されたキーフィールド「 instana-key 」、「 redis -password 」、「 proxy-user-pass 」を次のように使用する必要があります：

 kubectl create secret generic my-pop-secret  --namespace <namespace> \
 --from-literal=instana-key='<instana agent key>'  \
 --from-literal=redis-password='<redis password>'  \
 --from-literal=proxy-user-pass='<proxy username and password>'
 

downloadKey 鍵の秘密は、 kubernetes.io/dockerconfigjson タイプを使用する必要があります。 以下のようにして、 kubernetes.io/dockerconfigjson タイプのシークレットを作成できます。

kubectl create secret docker-registry my-pull-secret --namespace <namespace> --docker-server="https://containers.instana.io" --docker-username="_" --docker-password="<downloadKey>"
 

注:

• < namespace> を、シンセティック PoPのインストールに使用する名前空間に置き換えます。
• -- docker -username 引数の値を変更しないでください。
• 「 <downloadKey> 」を、 Instana のダウンロードキーに置き換えてください。

Syntheticの PoP, を監視するには、 PoP がインストールされている Kubernetes クラスターに、 Instana ホストエージェントをインストールすることをお勧めします。

Instana ホストエージェントのインストール後、 PoP を監視するために、 Syntheticの PoP センサーが自動的にインストールされます。 Instana のUIでメトリクスを確認でき、Syntheticの PoP に何らかの障害が発生した場合はアラートを受け取ることができます。

複数のノードがある Kubernetes クラスターでシンセティック PoP をアップグレードすると、 PoP コントローラー・ポッドが、意図したものとは異なるノードに割り当てられる場合があります。 PoP コントローラーが別のノードに割り当てられている場合、 PoP entityId が変更されます。 PoP モニター・ダッシュボードの PoP 正常性データは、POP entityIdに関連付けられているため、失われます。 この PoP で実行されているシンセティック・テストの結果と結果の詳細は影響を受けません。

PoP 正常性データが失われないようにするには、シンセティック PoPをアップグレードまたはインストールする前に、 PoP コントローラー・ポッドを固定ノードに割り当てます。

PoP コントローラーを固定ノードに割り当てるには、以下の手順を実行します。

1. 以下のコマンドを実行して、ノードにラベルを追加します。

   kubectl label nodes <yournode> scheduler=synthetic-pop-controller
    

2. ` helm install or` helm upgrade コマンドで、次のパラメータを指定してください： --set controller.nodeSelector.enabled=true

PoP コントローラー・ポッドを固定ノードに割り当て、このノードから他のポッドを除外するには、以下の手順を実行します。

1. 以下のコマンドを実行して、ノードにテイントを追加します。

   kubectl taint nodes <yournode> toleration=synthetic-pop-controller:PreferNoSchedule
    

2. ` helm install or` helm upgrade コマンドで、次のパラメータを指定してください： --set controller.taintSelector.enabled=true

PoP コントローラーのログ・ファイルに次のエラー・メッセージが表示された場合: Request failed with status code: 403

このエラーの考えられる理由:

• Instana キーが間違っています
• ライセンスが検証されていません。
• 「 URL 」というSyntheticエンドポイントは有効ですが、別のセルフホスト型インストール環境、または別の本番リージョンに属しています。

Instana SaaS, でこの問題を解決するには、以下の手順を実行してください：

1. Instana のUIで、 「Synthetic Monitoring 」>「 Locations」 に移動します。
2. 「場所を作成」 をクリックします。 「場所の作成」ダイアログが表示されます。
3. 「プライベート」を選択します。
4. 次へ をクリックします。
5. 「シンプル」 タブで、 controller.instanaKey パラメーターと controller.instanaSyntheticEndpoint パラメーターが正しく設定されているかどうかを確認します。
6. ライセンスが検証済みで、有効期限が切れていないかどうかを確認します。

Instana のセルフホスト版でこの問題を解決するには、以下の手順を実行してください：

1. Instana のUIで、 「Synthetic Monitoring 」>「 Locations」 に移動します。
2. Deploy a PoPをクリックします。 Deploy a PoPダイアログが表示されます。
3. 「シンプル」 タブで、 controller.instanaKey パラメーターと controller.instanaSyntheticEndpoint パラメーターが正しく設定されているかどうかを確認します。
4. 免許が有効かどうか、失効していないかどうかを確認する。

PoP コントローラーのログ・ファイルに次のエラー・メッセージが表示された場合: Request failed with status code: 404

このエラーの考えられる理由:

• 合成エンドポイント「 URL 」が正しく設定されていません。
• Instana のバックエンドをセルフホストで利用している場合、Syntheticのアクセプターまたはロードバランサーに何らかの問題が発生しています。

Instana SaaS, でこの問題を解決するには、以下の手順を実行してください：

1. Instana のUIで、 「Synthetic Monitoring 」>「 Locations」 に移動します。
2. 「場所を作成」 をクリックします。 「場所の作成」ダイアログが表示されます。
3. 「プライベート」を選択します。
4. 次へ をクリックします。
5. 「シンプル」 タブで、 controller.instanaKey パラメーターと controller.instanaSyntheticEndpoint パラメーターが正しく設定されているかどうかを確認します。

Instana のセルフホスト版でこの問題を解決するには、以下の手順を実行してください：

1. Instana のUIで、 「Synthetic Monitoring 」>「 Locations」 に移動します。
2. Deploy a PoPをクリックします。 Deploy a PoPダイアログが表示されます。
3. 「シンプル」 タブで、 controller.instanaKey パラメーターと controller.instanaSyntheticEndpoint パラメーターが正しく設定されているかどうかを確認します。

セルフホスト型の Instana バックエンドを使用しており、パラメータ controller.instanaSyntheticEndpoint が正しく設定されている場合は、ロードバランサーとSyntheticアクセプターが正常に動作しているか確認してください。 詳細については、 「ロードバランサーの設定」および DNS を参照してください

PoP コントローラーのログ・ファイルに次のエラー・メッセージが表示された場合: Request failed with status code: 503

このエラーの考えられる理由:

• セルフホスト型の Instana バックエンドをインストールした際に作成されたIngress、Route、または LoadBalancer サービスに何らかの問題が発生しています。

この問題を解決するには、セルフホスト型の Instana バックエンドをインストールした際に作成された、利用可能なIngress、Route、または LoadBalancer サービスを確認してください。 欠落しているサービスまたは無効なサービスを作成または更新してください。 詳細については、 「ロードバランサーの設定」および DNS を参照してください。

PoP コントローラーのログ・ファイルに次のエラー・メッセージが表示された場合: java.net.UnknownHostException: <hostname>: Name or service not known

このエラーの考えられる理由:

• controller.instanaSyntheticEndpoint パラメーターのホスト名が正しくありません。
• Kubernetes クラスタにおける DNS の問題。
• コントローラーに明示的なエグレス・ポリシーを追加する際の問題。

この問題を修正するには、以下の手順を実行します。

• controller.instanaSyntheticEndpoint パラメーターが正しく設定されているかどうかを確認してください。
• Kubernetes クラスタの DNS の設定を確認してください。 詳細は、「 DNS の解決のデバッグ」 を参照してください。
• ホスト名を controller.instanaSyntheticEndpoint パラメーターの IP アドレスに変更します。
• コントローラーで、ピアとの必要な通信をすべて許可するように、アウトバウンドのネットワークポリシーを明示的に設定します。 デフォルトのポリシーは「allowed-all」であり、すべてのポートから任意のピアへの送信を許可します。
• コントローラーでエグレス・ネットワーク・ポリシーを設定し、指定したピアまたはポート間の通信を許可します。 以下の例は、明示的に指定されたものを除き、すべての通信を拒否するポリシーを示しています。そのため、 Instana のエンドポイントとの通信が制限される可能性があります。

  egress:
    - ports:
      - port: 6379
        protocol: TCP
      to:
      - podSelector:
          matchLabels:
            app: redis
        namespaceSelector:
          matchLabels:
            kubernetes.io/metadata.name: {{ .Values.controller.redisNamespace }}
 

   egress:
    - ports:
      - port: 80
        protocol: TCP
      - port: 443
        protocol: TCP
 

自己署名証明書をテストするために SSLCertificate テストを作成すると、テストの実行が「証明書がありません」というエラーで失敗する場合があります。 この問題は、自己署名証明書がサポートされていないために発生します。 Instana （ OpenAPI, ）を使用してこの問題を解決するには、以下の手順に従ってください：

1. Instana のバックエンドのバージョンが 3.292.x であることを確認してください。
2. Syntheticの PoP を、バージョン 1.2.13 の R292 にアップグレードしてください。
3. 「PATCH」を適用して「 No certificate 」エラーを表示するSSLCertificateテストを更新します。ペイロードは以下の通りです：

{
  "configuration": {
    "acceptSelfSignedCertificate": true
  }
}
 

Instana のUIからこの問題を解決するには、以下の手順に従ってください：

1. Instana のバックエンドのバージョンが 3.297.x であることを確認してください。
2. Go 「Synthetic」のモニタリングに移動し、自己署名証明書を使用する「 SSL 」証明書テストを選択します。
3. 「 設定 」ページで「 編集 」をクリックし、「 自己署名証明書を受け入れる 」を選択します。