Menggunakan Recommender CLI dan API

Penganalisis Jaringan menggunakan Recommender perintah. Untuk mengetahui daftar lengkap jenis insight Recommender, lihat Jenis insight Recommender.

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 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 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 mungkin diterapkan sebelum atau setelah FILTER dan LIMIT.

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

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

API

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

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 Penganalisis Jaringan 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 dijelaskan.
  • PROJECT_ID: ID project yang berisi insight.
  • LOCATION: lokasi untuk mencantumkan insight.

  • INSIGHT_TYPE: jenis insight Penganalisis Jaringan 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 Penganalisis Jaringan 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.