ネットワーク接続テスト network-connectivity-test

ネットワーク接続テスト​は、環境でアドバンストネットワークを有効にする前と本番稼働前に、アドバンストネットワークとVPN設定を検証できるCloud Manager診断ツールです。 内部エンドポイントまたはプライベート エンドポイントを含め、AEMが到達する必要があるホストとポートが、アドバンストネットワークが使用するのと同じ接続パス経由で到達できることを確認するために使用します。

テストは、オーサーまたはパブリッシュ ポッドからではなく、プログラムの高度なネットワーク設定に属する​ エグレス プロキシ インフラストラクチャ ​から実行されます。 アドバンスドネットワークがアクティブな場合にAEMが使用するのと同じアウトバウンドネットワークパスを使用します。 この設計は、VPN シナリオで特に便利です。運用開始する前に、プライベート システムまたはオンプレミス システムのDNS解決、ネットワーク ルーティング、ファイアウォール ルール、サービスの可用性を確認できます。

VPNのプロビジョニング、専用エグレス IP、またはフレキシブル ポート エグレスの背景については、AEM as a Cloud Serviceの高度なネットワークの設定を参照してください。

このツールの使用条件 when-to-use

前提条件 prerequisites

テストの実行方法 how-to-run-a-test

入力フィールド input-fields

手順 test-steps

結果の把握 understanding-results

ツールは複数の寸法をレポートします。 これらは、ターゲットが高度なネットワークから到達できるかどうか、およびHTTP対応チェックがどのように動作するかを説明します。

DNS 解決 dns-resolution

ポートが開きました port-open

HTTP 接続 http-connectivity

すべてのポート​でHTTP/HTTPS要求が試行されます。 ツールは常に​ HTTPS ​を最初に試し、次に​ HTTP ​にフォールバックします。 どちらも機能しない場合、結果は、読み取り可能な短い​エラー メッセージにマッピングされます（以下の表を参照）。

成功の出力

分類されたエラー出力

到達可能性 reachability

複数のDNS リゾルバー multiple-dns-resolvers

アドバンスドネットワークインフラストラクチャが​ 複数のDNS リゾルバー ​を定義している場合：

トラブルシューティング troubleshooting

以下のシナリオは、ツールに表示される可能性が高いものと、原因を絞り込む手順を組み合わせたものです。 同じ状況を示す​クリップボードへの完全なコピー JSONについては、出力例を参照してください。

DNS解決に失敗しました dns-failed

出力

ホスト名がアドバンスドネットワーク DNS設定を使用して解決しなかったため、ツールはポートをテストできません。 結果ビューでは、DNS解決​にエラー文字列が表示され、到達性​はDNSが失敗したことを報告します。

DNS Resolution: error: "DNS resolution error: ..."
Reachability: "Unreachable: DNS resolution failed"

レコメンデーション

DNSは機能するが、ポートにアクセスできない dns-ok-port-blocked

出力

ツールはホストを解決できますが、ポートへのTCPは成功しません。 概要は次のようになります。

DNS Resolution: ips: ["10.0.1.50"]
Port Open: No
Reachability: "Unreachable: Port not accessible"

レコメンデーション

テストは到達可能ですが、AEMが接続しません reachable-but-aem-fails

出力

接続性チェック自体が成功します。 要約すると、次のようになります。

Port Open: Yes
Reachability: "Reachable"

その結果、Advanced Networkingからテストしたホストおよびポートへのパスが開きます。 これは、AEM アプリケーショントラフィックがそのパスを使用していることを保証するものではありません。コードの実行時に、サービスログに期待するエグレス IPからのリクエストが表示されない場合があります。

レコメンデーション

HTTPでエラーが表示されますが、ポートが開いている http-error-port-open

出力

TCPは成功しますが、HTTP/HTTPS プローブは依然として失敗を報告します。 概要は次のようになります。

Port Open: Yes
HTTP Connectivity: error: "Connection error: ..." or "Both HTTPS and HTTP failed. ..."
Reachability: "Reachable"

レコメンデーション

要求タイムアウト timeout

出力

{ "error": "Request timeout" }

レコメンデーション

出力例 example-outputs

HTTPS テストの成功（例：ポート 443の内部API） example-output-successful-https

{
  "resolvers": [
    {
      "name": "default",
      "dns_resolution": {
        "ips": ["10.0.1.50"]
      },
      "port_open": true,
      "http_connectivity": {
        "protocol": "https",
        "status_code": 200,
        "reason": "200 OK"
      },
      "reachability": "Reachable"
    }
  ]
}

HTTP以外のサービスのテストに成功しました（例：ポート 5432のデータベース） example-output-successful-non-http

{
  "resolvers": [
    {
      "name": "default",
      "dns_resolution": {
        "ips": ["10.0.1.50"]
      },
      "port_open": true,
      "http_connectivity": {
        "error": "Not an HTTP/HTTPS service",
        "note": "The service appears to be a non-HTTP service (e.g., database, message queue, or custom TCP). Use the port_open and reachability fields to verify connectivity."
      },
      "reachability": "Reachable"
    }
  ]
}

DNS解決の失敗 example-output-dns-resolution-failure

{
  "resolvers": [
    {
      "name": "default",
      "dns_resolution": {
        "error": "DNS resolution error: dial udp 10.0.0.2:53: i/o timeout"
      },
      "port_open": false,
      "http_connectivity": {
        "error": "DNS resolution failed"
      },
      "reachability": "Unreachable: DNS resolution failed"
    }
  ]
}

ポートにアクセスできません（ファイアウォール / サービスダウン） example-output-port-not-accessible

{
  "resolvers": [
    {
      "name": "default",
      "dns_resolution": {
        "ips": ["10.0.1.50"]
      },
      "port_open": false,
      "http_connectivity": {
        "error": "Connection error: dial tcp 10.0.1.50:443: i/o timeout"
      },
      "reachability": "Unreachable: Port not accessible"
    }
  ]
}

重要な注意事項 important-notes

このテストで実行できないこと what-this-test-does-not-do

応答時間 response-time

HTTPと非HTTP サービス http-vs-non-http-services

ツールは、すべてのポートでHTTP/HTTPS接続を試みます。 HTTP以外のサービス（例えば、ポート 5432のPostgreSQL、3306のMySQL、22のSFTP、6379のRedis）の場合、HTTP チェックは接続エラーで失敗する可能性があります。これは予想されます。 これらのサービスの接続を確認するには、Port openとReachabilityに依存します。

関連する情報 related-information