Mendapatkan diagnostik

Dengan diagnostik Cloud Interconnect, Anda dapat memecahkan masalah koneksi Dedicated Interconnect selama penyediaan dan setelah aktivasi.

Diagnostik memberikan informasi teknis terbaru yang mendetail tentang sisi Google Cloud dari koneksi Dedicated Interconnect sesuai permintaan.

Diagnostik selama pemadaman layanan

Jika terjadi pemadaman layanan global, jangan gunakan hasil diagnostik dari koneksi Dedicated Interconnect untuk membuat keputusan tentang tempat pengalihan traffic jaringan Anda.

Tidak seperti lampiran VLAN yang bersifat regional, koneksi Dedicated Interconnect adalah resource global. Pemadaman layanan global dapat mencegah diagnostik untuk Cloud Interconnect berfungsi dengan baik.

Diagnostik selama penyediaan

Dengan melihat diagnostik, Anda akan mendapatkan informasi yang diperlukan untuk memecahkan dan memperbaiki masalah dalam konfigurasi router lokal, yang dapat membantu jika koneksi Dedicated Interconnect gagal melalui proses penyediaan.

Hasil diagnostik berisi data yang berbeda, bergantung pada tahap mana dalam proses penyediaan koneksi Dedicated Interconnect Anda berada. Langkah mayor dan minor tercantum di bagian berikutnya. Informasi diagnostik ini memberi Anda kemungkinan langkah selanjutnya yang harus dilakukan agar proses penyediaan berlangsung tanpa masalah lebih lanjut.

Gunakan referensi output perintah untuk menafsirkan hasil perintah diagnostik atau informasi yang diberikan di konsol Google Cloud .

Tahap penyediaan

Proses penyediaan koneksi Dedicated Interconnect terjadi dalam beberapa tahap. Anda harus memenuhi persyaratan berikut di setiap tahap sebelum dapat melanjutkan ke tahap berikutnya:

  • Tahap 1 - Koneksi Sirkuit:

    • Status daya optik adalah OK untuk setiap link dalam koneksi.
  • Tahap 2 - Kualifikasi Sirkuit (hanya untuk koneksi yang memiliki lebih dari satu link):

    • Status daya optik adalah OK untuk setiap link dalam koneksi.
    • Setiap link akan diberi alamat IP sementara. Alamat digunakan untuk mengkualifikasi setiap link secara individual melalui pengujian ping.
    • Terdapat entri Address Resolution Protocol (ARP).
  • Tahap 3 - Konfigurasi Produksi:

    • Status daya optik adalah OK untuk setiap link dalam koneksi.
    • Semua link dalam koneksi dikonfigurasi dalam paket LACP.
    • Alamat IP sementara ditetapkan ke antarmuka paket yang tidak diberi tag. Google Cloud memverifikasi konektivitas melalui ping. Alamat IP uji akan dihapus setelah proses aktivasi selesai.
    • Terdapat entri ARP.

Menggunakan diagnostik

Untuk melihat informasi diagnostik untuk koneksi Dedicated Interconnect, ikuti langkah-langkah berikut.

Konsol

  1. Di konsol Google Cloud , buka tab Koneksi fisik Cloud Interconnect.

    Buka Koneksi fisik

  2. Pilih nama koneksi Dedicated Interconnect.

  3. Informasi diagnostik terdapat di lokasi berikut pada halaman detail koneksi:

    • Untuk peringatan atau error, lihat kolom Status.
    • Untuk mengetahui kapasitas yang disediakan untuk Dedicated Interconnect, lihat kolom Kapasitas yang disediakan.
    • Jika Anda mencurigai adanya masalah pada koneksi Dedicated Interconnect, lihat bagian lampiran VLAN untuk mengetahui informasi seperti kapasitas efektif koneksi atau jumlah link yang bermasalah.
    • Untuk detail tambahan, seperti tingkat cahaya, lihat bagian Info sirkuit link.

gcloud

Gunakan perintah gcloud compute interconnects get-diagnostics:

gcloud compute interconnects get-diagnostics NAME
    --project=PROJECT_ID

Ganti kode berikut:

  • NAME: nama koneksi Dedicated Interconnect di project Anda
  • PROJECT_ID: ID Google Cloud project

Outputnya mirip dengan hal berikut ini:

macAddress: "00:11:22:33:44:55"
arpCache:
  macAddress: "55:44:33:22:11:00"
  ipAddress: "1.2.3.4"
links:
  - circuitId: "circuit-id-1"
    receivingOpticalPower:
      value: 0.4
      state: OK
    lacpStatus:
      state: ACTIVE
      googleSystemId: "00:11:22:33:44:55"
      neighborSystemId: "55:44:33:22:11:00"
     macsec:
      ckn: 0101010189abcdef...0123456789abcdef
      operational: true
  - circuitId: "circuit-id-2"
    receivingOpticalPower:
      value: 0.4
      state: OK
    lacpStatus:
      state: DETACHED
    macsec:
      ckn: 0101010189abcdef...0123456789abcdef
      operational: false
    arpCache:
      macAddress: "01:23:45:67:89:0a"
      ipAddress: "2.3.4.5"

API

Gunakan metode interconnects.getDiagnostics :

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME/getDiagnostics

Ganti kode berikut:

  • PROJECT_ID: ID Google Cloud project
  • NAME: nama koneksi Dedicated Interconnect di project Anda

Jika berhasil, perintah ini akan menampilkan output InterconnectDiagnostics dalam format berikut. Untuk menafsirkan output, lihat referensi output perintah.

{
  "macAddress": "00:11:22:33:44:55",
  "arpCache": [
    {
      "macAddress": "55:44:33:22:11:00",
      "ipAddress": "1.2.3.4"
    }
  ],
  "links": [
    {
      "circuitId": "circuit-id",
      "receivingOpticalPower": {
        "value": 0.4,
        "state": OK,
      },
      "lacpStatus": {
        "state": ACTIVE,
        "googleSystemId": "00:11:22:33:44:55",
        "neighborSystemId": "55:44:33:22:11:00"
      }
    },
    {
      "circuitId": "circuit-id",
      "receivingOpticalPower": {
        "value": 0.4,
        "state": OK,
      },
      "lacpStatus": {
        "state": DETACHED
      },
      "arpCache": [
        {
          "macAddress": "01:23:45:67:89:0a",
          "ipAddress": "2.3.4.5"
        }
      ]
    }
  ]
}

Menggunakan diagnostik dari grup koneksi

Anda juga bisa mendapatkan diagnostik gabungan dari semua koneksi antar-jaringan dalam grup koneksi antar-jaringan.

Konsol

  1. Di konsol Google Cloud , buka tab Koneksi fisik Cloud Interconnect.

    Buka Koneksi fisik

  2. Di tabel Grup Interconnect, pilih nama grup koneksi Dedicated Interconnect.

  3. Informasi diagnostik terdapat di lokasi berikut pada halaman detail grup:

    • Di dekat bagian atas halaman, Anda dapat melihat status dan deskripsi grup.
    • Di bagian status dan deskripsi, Anda dapat melihat jumlah koneksi yang aktif, SLA yang diinginkan, dan apakah Anda memenuhi syarat untuk SLA yang diinginkan.
    • Jika ada penghambat yang mencegah grup koneksi Anda memenuhi persyaratan SLA yang diinginkan, penghambat tersebut akan muncul di kolom Penghambat kelayakan SLA di bagian sebelumnya.
    • Tabel di bagian bawah halaman menampilkan detail tentang setiap koneksi dalam grup koneksi Anda.

gcloud

Gunakan perintah gcloud compute interconnects groups get-operational-status, dengan mengganti NAME dengan nama koneksi Dedicated Interconnect yang ingin Anda periksa:

gcloud compute interconnects groups get-operational-status NAME

Menggunakan diagnostik dari grup lampiran VLAN

Anda bisa mendapatkan diagnostik gabungan dari semua lampiran VLAN dalam grup lampiran VLAN.

Konsol

  1. Di konsol Google Cloud , buka tab Lampiran VLAN Cloud Interconnect.

    Buka lampiran VLAN

  2. Pilih grup lampiran VLAN yang ingin Anda edit.

  3. Informasi diagnostik terdapat di lokasi berikut pada halaman detail grup:

    • Di dekat bagian atas halaman, Anda dapat melihat status dan deskripsi grup.
    • Di bagian status dan deskripsi, Anda dapat melihat jumlah lampiran VLAN yang aktif, SLA yang diinginkan, dan apakah Anda memenuhi syarat untuk SLA yang diinginkan.
    • Jika ada pemblokir yang mencegah grup lampiran VLAN Anda memenuhi persyaratan SLA yang diinginkan, pemblokir tersebut akan muncul di kolom Pemblokir kelayakan SLA di bagian sebelumnya.
    • Tabel di bagian bawah halaman menampilkan detail tentang setiap lampiran VLAN dalam grup lampiran VLAN Anda.

gcloud

Gunakan perintah gcloud compute interconnects attachments groups get-operational-status:

gcloud compute interconnects attachments groups get-operational-status NAME

Ganti kode berikut:

  • NAME: nama grup lampiran VLAN di project Anda

Outputnya mirip dengan hal berikut ini:

result:
attachmentStatuses:
- adminEnabled: true
  attachment: https://www.googleapis.com/compute/v1/projects/equinix-gci-testing/regions/us-west2/interconnectAttachments/byohsm-lab-sfo-attachment3
  isActive: ACTIVE
  status: CONNECTION_UP
- adminEnabled: true
  attachment: https://www.googleapis.com/compute/v1/projects/equinix-gci-testing/regions/us-west2/interconnectAttachments/ccsw03-sfo05-z1-a1
  isActive: ACTIVE
  status: CONNECTION_UP
configured:
  availabilitySla:
    effectiveSla: PRODUCTION_NON_CRITICAL
groupStatus: FULLY_UP
intent:
  availabilitySla: PRODUCTION_NON_CRITICAL
operational:
  availabilitySla:
    effectiveSla: PRODUCTION_NON_CRITICAL

Referensi output perintah

Definisi parameter output untuk perintah Google Cloud CLI dan interconnects.getDiagnostics API tercantum dalam tabel berikut.

Parameter output Deskripsi
macAddress Menjelaskan alamat MAC paket koneksi Dedicated Interconnect di sisi Google Cloud .
arpCache Menjelaskan setiap tetangga yang terlihat oleh Cloud Router dalam cache ARP untuk koneksi Dedicated Interconnect. Kolom ini kosong jika koneksi tidak dipaketkan.
arpCache[].macAddress Mencantumkan alamat MAC tetangga ARP ini.
arpCache[].ipAddress Mencantumkan alamat IP tetangga ARP ini.
links[] Menjelaskan status untuk setiap link pada koneksi Dedicated Interconnect.
links[].circuitId Mencantumkan ID unik yang ditetapkan Google untuk sirkuit ini, seperti yang ditetapkan selama pengaktifan sirkuit.
links[].googleDemarc Menjelaskan demarkasi yang ditetapkan Google, seperti yang ditetapkan pada saat pengaktifan sirkuit dan diberikan oleh Google kepada pelanggan di LOA.
links[].macsec Status MACsec link. Kolom ini dihilangkan jika Anda tidak mengaktifkan MACsec.
links[].macsec.ckn Nama kunci asosiasi konektivitas (CKN) yang digunakan. Kolom ini dihilangkan jika Anda tidak mengaktifkan MACsec.
links[].macsec.operational

Status MACsec link. Kolom ini dihilangkan jika Anda tidak mengaktifkan MACsec. Berikut adalah nilai yang memungkinkan:

  • BENAR: MACsec beroperasi pada link.
  • SALAH: MACsec tidak beroperasi pada link.
links[].operationalState

Status operasional link Dedicated Interconnect ini. Kolom ini dihilangkan jika Anda tidak mengaktifkan MACsec. Berikut adalah nilai yang memungkinkan:

  • LINK_OPERATIONAL_STATUS_UP: Link sudah beroperasi.
  • LINK_OPERATIONAL_STATUS_DOWN: Link tidak beroperasi.

Status operasional link tidak terpengaruh oleh status MACsec link.

links[].receivingOpticalPower Menjelaskan nilai dan status saat ini untuk tingkat cahaya yang diterima.
links[].receivingOpticalPower.value Mencantumkan nilai saat ini dari tingkat cahaya yang diterima, dalam satuan dBm.
links[].receivingOpticalPower.state

Status nilai saat ini jika dibandingkan dengan tingkat peringatan dan alarm untuk transceiver penerima:

  • OK: Nilai belum melewati ambang batas peringatan.
  • LOW_WARNING: Nilai telah melewati ambang batas peringatan rendah.
  • HIGH_WARNING: Nilai telah melewati ambang batas peringatan tinggi.
  • LOW_ALARM: Nilai telah melewati ambang batas alarm rendah.
  • HIGH_ALARM: Nilai telah melewati ambang batas alarm tinggi.
links[].transmittingOpticalPower Nilai dan status saat ini untuk tingkat cahaya pengiriman.
links[].transmittingOpticalPower.value Nilai saat ini dari tingkat cahaya pengiriman, dalam satuan dBm.
links[].transmittingOpticalPower.state

Status nilai saat ini jika dibandingkan dengan tingkat peringatan dan alarm untuk transceiver pengiriman:

  • OK: Nilai belum melewati ambang batas peringatan.
  • LOW_WARNING: Nilai telah melewati ambang batas peringatan rendah.
  • HIGH_WARNING: Nilai telah melewati ambang batas peringatan tinggi.
  • LOW_ALARM: Nilai telah melewati ambang batas alarm rendah.
  • HIGH_ALARM: Nilai telah melewati ambang batas alarm tinggi.
links[].lacpStatus Informasi LACP untuk satu link.
links[].lacpStatus.state
  • ACTIVE: Link dikonfigurasi dan aktif di dalam paket.
  • DETACHED: Link tidak dikonfigurasi di dalam paket.
links[].lacpStatus.googleSystemId ID sistem port di sisi Google Cloud dari pertukaran LACP.
links[].lacpStatus.neighborSystemId ID sistem port di sisi pelanggan dari pertukaran LACP.
links[].arpCache[] Daftar objek InterconnectDiagnostics.ARPEntry, yang menjelaskan entri ARP tetangga yang terlihat pada link ini. Kolom ini kosong jika link dipaketkan.
links[].arpCache[].macAddress Alamat MAC tetangga ARP pada link ini.
links[].arpCache[].ipAddress Alamat IP tetangga ARP pada link ini.

Langkah selanjutnya