Menggunakan Recommender CLI dan API

Network Analyzer menggunakan perintah Recommender. Recommender adalah layanan Google Cloud yang memberikan rekomendasi penggunaan untuk produk dan layanan Google Cloud. Untuk mengetahui daftar lengkap jenis insight Pemberi rekomendasi, lihat jenis insight Pemberi rekomendasi.

Meminta insight

gcloud

Untuk mencantumkan insight project Google Cloud, 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 insight-nya ingin Anda cantumkan. 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 Penganalisis Jaringan yang akan diminta, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

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

Kolom berikut bersifat opsional:

  • EXPRESSION: terapkan 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, 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 akan ada paging. Pembagian halaman dapat diterapkan sebelum atau setelah FILTER dan LIMIT.

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

    Urutan defaultnya adalah menaik. Untuk menentukan urutan menurun, beri awalan kolom dengan ~ (tilde).

API

Untuk mendapatkan insight untuk 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"
}

Menjelaskan 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 Penganalisis Jaringan, 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 Penganalisis Jaringan, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

    Untuk mengetahui daftar lengkap jenis insight, lihat Jenis dan grup insight.

  • INSIGHT_ID: ID insight untuk insight.

Jenis dan grup insight

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