Recommender CLI 및 API 사용

네트워크 분석기는 추천자 명령어를 사용합니다. 추천자는 Google Cloud 제품 및 서비스 사용에 관한 권장사항을 제공하는 Google Cloud 서비스입니다. 추천자 통계 유형의 전체 목록은 추천자 통계 유형을 참조하세요.

요청 통계

gcloud

Google Cloud 프로젝트의 통계를 나열하려면 다음 명령어를 실행합니다.

gcloud recommender insights list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --insight-type=INSIGHT_TYPE \
    --filter=EXPRESSION \
    --limit=LIMIT \
    --page-size=PAGE_SIZE \
    --sort-by=SORT_BY \
    --format=json

다음을 바꿉니다.

  • PROJECT_ID: 통계를 나열할 프로젝트 ID입니다. 폴더, 조직, 결제 계정에 대한 모든 통계를 나열할 수도 있습니다.
  • LOCATION: 통계를 나열할 위치입니다(예: global, europe, asia-east1 또는 us-central1-a).

  • INSIGHT_TYPE: 요청할 네트워크 분석기 통계 유형입니다(예: google.networkanalyzer.vpcnetwork.connectivityInsight).

    통계 유형의 전체 목록은 통계 그룹 및 유형을 참조하세요.

다음 필드는 선택사항입니다.

  • EXPRESSION: 나열하려는 각 리소스에 이 부울 필터를 적용합니다.

    표현식이 True로 평가되면 해당 항목이 나열됩니다. 필터 표현식의 세부정보 및 예시를 보려면 $ gcloud topic filters를 실행하거나 gcloud topic filters 문서를 참조하세요.

  • LIMIT: 나열할 최대 리소스 수입니다. 나열된 기본 리소스 수는 무제한입니다.

  • PAGE_SIZE: 페이지당 나열할 최대 리소스 수입니다.

    기본 페이지 크기는 서비스에 따라 결정됩니다. 그렇지 않으면 페이징되지 않습니다. 페이징은 FILTER 및 LIMIT 전후에 적용될 수 있습니다.

  • SORT_BY: 리소스별로 정렬할 필드 키를 쉼표로 구분한 목록입니다.

    기본 순서는 오름차순입니다. 내림차순을 지정하려면 필드 앞에 ~(물결표)을 붙입니다.

API

Google Cloud 프로젝트의 통계를 가져오려면 projects.locations.insightTypes.insights 메서드에 대해 GET 요청을 실행합니다.

https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID
  • LOCATION: 통계를 나열할 위치입니다(예: global, europe, asia-east1 또는 us-central1-a).

  • INSIGHT_TYPE: 나열할 네트워크 분석기 통계 유형입니다(예: google.networkanalyzer.vpcnetwork.connectivityInsight).

    통계 유형의 전체 목록은 통계 그룹 및 유형을 참조하세요.

다음 예시는 이 명령어의 샘플 응답을 보여줍니다.

{
  "name": "projects/{project_number}/locations/{location}/insightTypes/google.networkanalyzer.hybridconnectivity.dynamicRouteInsight/insights/{insight_id}",
  "description": "Dynamic route is fully shadowed by a peering subnet route",
  "content": {
    "networkUri": "//compute.googleapis.com/projects/{project_id}/global/networks/{network_name}",
    "region": "{location}",
    "ipRange": "{ip_range}",
    "priority": 100,
    "nextHopUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}",
    "cloudRouterUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/routers/{router_name}",
    "shadowingRouteUris": [
      "//compute.googleapis.com/projects/{project_id}/global/routes/{route_name}"
    ],
    "shadowingRouteType": "PEERING_SUBNET"
  },
  "lastRefreshTime": "2022-09-15T21:10:57.187942979Z",
  "observationPeriod": "611870.625920374s",
  "stateInfo": {
    "state": "ACTIVE"
  },
  "category": "PERFORMANCE",
  "targetResources": [
    "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}"
  ],
  "insightSubtype": "DYNAMIC_ROUTE_FULLY_SHADOWED",
  "severity": "MEDIUM"
}

통계 세부정보 설명

gcloud

특정 통계의 세부정보를 나열하려면 다음 명령어를 실행합니다.

gcloud recommender insights describe INSIGHT_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --insight-type=INSIGHT_TYPE

다음을 바꿉니다.

  • INSIGHT_ID: 설명할 통계의 ID입니다.
  • PROJECT_ID: 통계가 포함된 프로젝트의 ID입니다.
  • LOCATION: 통계를 나열할 위치입니다.

  • INSIGHT_TYPE: 통계의 네트워크 분석기 통계 유형입니다(예: google.networkanalyzer.vpcnetwork.connectivityInsight).

    통계 유형의 전체 목록은 통계 그룹 및 유형을 참조하세요.

API

통계에 대한 세부정보를 가져오려면 projects.locations.insightTypes.insights 메서드에 대해 GET 요청을 실행합니다.

https://recommender.googleapis.com/v1/projects/PROJECT/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights/INSIGHT_ID

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID
  • LOCATION: 통계의 위치입니다.

  • INSIGHT_TYPE: 통계의 네트워크 분석기 통계 유형입니다(예: google.networkanalyzer.vpcnetwork.connectivityInsight).

    통계 유형의 전체 목록은 통계 그룹 및 유형을 참조하세요.

  • INSIGHT_ID: 통계의 통계 ID입니다.

통계 그룹 및 유형

네트워크 분석기 통계에 대한 자세한 내용은 통계 그룹 및 유형을 참조하세요.