Menggunakan Recommender CLI dan API

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

Meminta analisis

gcloud

Untuk menampilkan daftar 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 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 Jenis dan grup insight.

Kolom berikut bersifat opsional:

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

    Jika ekspresi dievaluasi sebagai 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 dicantumkan; jumlah default resource yang tercantum adalah tidak terbatas.

  • PAGE_SIZE: jumlah maksimum resource yang dicantumkan per halaman.

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

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

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

API

Untuk mendapatkan insight terkait 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 Jenis dan grup 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 wawasan

gcloud

Untuk menampilkan 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 Network Analyzer, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

    Untuk mengetahui daftar lengkap jenis insight, lihat Jenis dan grup 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, seperti google.networkanalyzer.vpcnetwork.connectivityInsight.

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

  • INSIGHT_ID: ID insight untuk insight.

Grup dan jenis insight

Untuk mengetahui informasi selengkapnya tentang insight Network Analyzer, lihat Grup dan jenis insight.