Menggunakan Recommender CLI dan API

Anda dapat menggunakan Recommender API atau Google Cloud CLI untuk melihat insight Network Analyzer. Dokumen ini menunjukkan cara melihat insight untuk jenis insight Penganalisis Jaringan tertentu.

Meminta insight

gcloud

Untuk mencantumkan insight untuk Google Cloud project, jalankan perintah berikut:

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

Ganti kode berikut:

  • PROJECT_ID: project ID yang ingin Anda cantumkan insight-nya. Anda juga dapat mencantumkan semua insight untuk folder, organisasi, atau akun penagihan.
  • LOCATION: lokasi untuk mencantumkan insight, seperti global, europe, asia-east1, atau us-central1-a.

  • INSIGHT_TYPE: jenis insight Network Analyzer yang akan diminta, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

    Untuk mengetahui daftar lengkap jenis insight, lihat Grup dan jenis insight.

Kolom berikut bersifat opsional:

  • EXPRESSION: menerapkan filter Boolean ini ke setiap resource yang ingin Anda cantumkan.

    Jika ekspresi bernilai True, item tersebut akan dicantumkan. Untuk mengetahui detail dan contoh ekspresi filter selengkapnya, jalankan $ gcloud topic filters atau lihat dokumentasi gcloud topic filters.

  • LIMIT: jumlah maksimum resource yang akan dicantumkan; jumlah default resource yang dicantumkan tidak terbatas.

  • PAGE_SIZE: jumlah maksimum resource yang akan dicantumkan per halaman.

    Ukuran halaman default ditentukan oleh layanan; jika tidak, tidak ada paging. Paging dapat diterapkan sebelum atau setelah FILTER dan LIMIT.

  • SORT_BY: daftar nama kunci kolom yang dipisahkan koma untuk mengurutkan resource.

    Urutan defaultnya adalah menaik. Untuk menentukan urutan menurun, awali kolom dengan ~ (tanda gelombang).

API

Untuk mendapatkan insight project Google Cloud , buat permintaan GET ke metode projects.locations.insightTypes.insights:

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

Ganti kode berikut:

  • PROJECT_ID: project ID.
  • LOCATION: lokasi untuk mencantumkan insight, seperti global, europe, asia-east1, atau us-central1-a.

  • INSIGHT_TYPE: jenis insight Network Analyzer yang akan dicantumkan, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

    Untuk mengetahui daftar lengkap jenis insight, lihat Grup dan jenis insight.

Contoh berikut menunjukkan contoh respons untuk perintah ini:

{
  "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"
}

Mendeskripsikan detail insight

gcloud

Untuk mencantumkan detail insight tertentu, jalankan perintah berikut:

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

Ganti kode berikut:

  • INSIGHT_ID: ID insight yang akan dideskripsikan.
  • PROJECT_ID: ID project yang berisi insight.
  • LOCATION: lokasi untuk mencantumkan insight.

  • INSIGHT_TYPE: jenis insight Network Analyzer dari insight, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

    Untuk mengetahui daftar lengkap jenis insight, lihat Grup dan jenis insight.

API

Untuk mendapatkan detail insight, buat permintaan GET ke metode projects.locations.insightTypes.insights:

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

Ganti kode berikut:

  • PROJECT_ID: project ID.
  • LOCATION: lokasi insight.

  • INSIGHT_TYPE: jenis insight Network Analyzer dari insight, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

    Untuk mengetahui daftar lengkap jenis insight, lihat Grup dan jenis insight.

  • INSIGHT_ID: ID insight untuk insight.

Grup dan jenis insight

Untuk mengetahui informasi selengkapnya tentang insight Penganalisis Jaringan, lihat Grup dan jenis insight.