네트워크 연결 테스트 network-connectivity-test

네트워크 연결 테스트​는 환경에서 고급 네트워킹을 활성화하기 전과 라이브로 전환하기 전에 고급 네트워킹 및 VPN 구성을 확인할 수 있는 Cloud Manager 진단 도구입니다. 고급 네트워킹에서 사용할 연결 경로를 통해 내부 또는 개인 끝점을 포함하여 AEM에서 도달해야 하는 호스트 및 포트를 확인할 수 있습니다.

테스트는 작성자 또는 게시 pod가 아니라 프로그램의 고급 네트워킹 설정에 속하는 이그레스 프록시 인프라​에서 실행됩니다. 고급 네트워킹이 활성 상태일 때 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 Resolver 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"

이 결과는 고급 네트워킹에서 테스트한 호스트 및 포트로의 경로가 열려 있음을 의미합니다. 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