Mengumpulkan log VMware vSphere
Dokumen ini menjelaskan cara menyerap log VMware vSphere ke Google Security Operations menggunakan agen Bindplane.
VMware vSphere adalah platform virtualisasi yang menghasilkan pesan syslog untuk peristiwa host ESXi, operasi VM, autentikasi, dan pemantauan kesehatan sistem.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Windows Server 2016 atau yang lebih baru, atau host Linux dengan
systemd - Konektivitas jaringan antara agen Bindplane dan host ESXi VMware vSphere
- Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
- Akses istimewa ke VMware vSphere Web Client atau ESXi Shell
Mendapatkan file autentikasi penyerapan Google SecOps
- Login ke konsol Google SecOps.
- Buka Setelan SIEM > Agen Pengumpulan.
- Download File Autentikasi Penyerapan.
Simpan file dengan aman di sistem tempat BindPlane akan diinstal.
Mendapatkan ID pelanggan Google SecOps
- Login ke konsol Google SecOps.
- Buka Setelan SIEM > Profil.
Salin dan simpan ID Pelanggan dari bagian Detail Organisasi.
Menginstal agen Bindplane
Instal agen Bindplane di sistem operasi Windows atau Linux Anda sesuai dengan petunjuk berikut.
Penginstalan Windows
- Buka Command Prompt atau PowerShell sebagai administrator.
Jalankan perintah berikut:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietTunggu hingga penginstalan selesai.
Verifikasi penginstalan dengan menjalankan:
sc query observiq-otel-collectorLayanan akan ditampilkan sebagai RUNNING.
Penginstalan Linux
- Buka terminal dengan hak istimewa root atau sudo.
Jalankan perintah berikut:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shTunggu hingga penginstalan selesai.
Verifikasi penginstalan dengan menjalankan:
sudo systemctl status observiq-otel-collectorLayanan akan ditampilkan sebagai aktif (berjalan).
Referensi penginstalan tambahan
Untuk opsi penginstalan dan pemecahan masalah tambahan, lihat Panduan penginstalan agen BindPlane.
Mengonfigurasi agen Bindplane untuk menyerap syslog dan mengirimkannya ke Google SecOps
Cari file konfigurasi
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edit file konfigurasi
Ganti seluruh konten
config.yamldengan konfigurasi berikut:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/vmware_vsphere: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: VMWARE_VSPHERE raw_log_field: body service: pipelines: logs/vmware_vsphere_to_chronicle: receivers: - udplog exporters: - chronicle/vmware_vsphere
Parameter konfigurasi
Ganti placeholder berikut:
Konfigurasi penerima:
listen_address: Alamat IP dan port yang akan diproses:0.0.0.0untuk mendengarkan di semua antarmuka (direkomendasikan)- Port
514adalah port syslog standar (memerlukan root di Linux; gunakan1514untuk non-root)
Konfigurasi eksportir:
creds_file_path: Jalur lengkap ke file autentikasi penyerapan:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: ID Pelanggan yang disalin dari konsol Google SecOpsendpoint: URL endpoint regional:- Amerika Serikat:
malachiteingestion-pa.googleapis.com - Eropa:
europe-malachiteingestion-pa.googleapis.com - Asia:
asia-southeast1-malachiteingestion-pa.googleapis.com - Lihat Endpoint Regional untuk mengetahui daftar lengkapnya
- Amerika Serikat:
Simpan file konfigurasi
- Setelah mengedit, simpan file:
- Linux: Tekan
Ctrl+O, laluEnter, laluCtrl+X - Windows: Klik File > Save
- Linux: Tekan
Mulai ulang agen Bindplane untuk menerapkan perubahan
Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:
sudo systemctl restart observiq-otel-collectorPastikan layanan sedang berjalan:
sudo systemctl status observiq-otel-collectorPeriksa log untuk mengetahui error:
sudo journalctl -u observiq-otel-collector -f
Untuk memulai ulang agen Bindplane di Windows, pilih salah satu opsi berikut:
Command Prompt atau PowerShell sebagai administrator:
net stop observiq-otel-collector && net start observiq-otel-collectorKonsol layanan:
- Tekan
Win+R, ketikservices.msc, lalu tekan Enter. - Temukan observIQ OpenTelemetry Collector.
- Klik kanan, lalu pilih Mulai Ulang.
Pastikan layanan sedang berjalan:
sc query observiq-otel-collectorPeriksa log untuk mengetahui error:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Tekan
Mengonfigurasi syslog di VMware vSphere
Opsi 1: vSphere Web Client
- Login ke vSphere Web Client.
- Pilih host ESXi.
- Buka Konfigurasi > Sistem > Setelan Sistem Lanjutan.
- Klik Edit.
- Tetapkan parameter
Syslog.global.logHostkeudp://<bindplane-ip>:514(ganti<bindplane-ip>dengan alamat IP agen Bindplane Anda). - Klik Oke.
Opsi 2: ESXi Shell
- SSH ke host ESXi.
Jalankan perintah berikut:
esxcli system syslog config set --loghost=udp://<bindplane-ip>:514 esxcli system syslog reload- Ganti
<bindplane-ip>dengan alamat IP agen Bindplane Anda.
- Ganti
Tabel pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
Originator_label |
additional.fields |
Digabung |
activityType_label |
additional.fields |
Digabung |
certVerificationStatus_label |
additional.fields |
Digabung |
cls_simple_activity_label |
additional.fields |
Digabung |
itemType_label |
additional.fields |
Digabung |
logtype_label |
additional.fields |
Digabung |
opID_label |
additional.fields |
Digabung |
progress_label |
additional.fields |
Digabung |
securityCompliance_label |
additional.fields |
Digabung |
sub_label |
additional.fields |
Digabung |
vpxd_label |
additional.fields |
Digabung |
column9 |
extensions.auth.type |
Dipetakan: logged out → AUTHTYPE_UNSPECIFIED |
column9 |
metadata.description |
Dipetakan secara langsung |
msg |
metadata.description |
Dipetakan secara langsung |
response_Message |
metadata.description |
Dipetakan secara langsung |
column3 |
metadata.event_timestamp |
Diurai sebagai ISO8601 |
column9 |
metadata.event_type |
Dipetakan: logged out → USER_LOGOUT |
has_principal |
metadata.event_type |
Dipetakan: true → NETWOK_CONNECTION, true → STATUS_UPDATE |
column4 |
metadata.product_event_type |
Dipetakan secara langsung |
column1 |
metadata.product_log_id |
Dipetakan secara langsung |
uuid |
metadata.product_log_id |
Dipetakan secara langsung |
user_agent |
network.http.parsed_user_agent |
Diganti nama/dipetakan |
user_agent |
network.http.user_agent |
Dipetakan secara langsung |
sessionId |
network.session_id |
Dipetakan secara langsung |
Hostname |
principal.asset.hostname |
Dipetakan secara langsung |
hostname |
principal.asset.hostname |
Dipetakan secara langsung |
srcip |
principal.asset.ip |
Digabung |
Hostname |
principal.hostname |
Dipetakan secara langsung |
hostname |
principal.hostname |
Dipetakan secara langsung |
srcip |
principal.ip |
Digabung |
column5 |
security_result.severity |
Dipetakan: INFO → INFORMATIONAL |
severity |
security_result.severity_details |
Dipetakan secara langsung |
pid |
target.process.pid |
Dipetakan secara langsung |
column7 |
target.resource.name |
Dipetakan secara langsung |
column6 |
target.user.userid |
Dipetakan secara langsung |
| T/A | extensions.auth.type |
Konstanta: AUTHTYPE_UNSPECIFIED |
| T/A | metadata.event_type |
Konstanta: NETWOK_CONNECTION |
| T/A | metadata.product_name |
Konstanta: VMWARE_VSPHERE |
| T/A | metadata.vendor_name |
Konstanta: VMWARE_VSPHERE |
| T/A | security_result.severity |
Konstanta: INFORMATIONAL |
timestamp |
event.idm.read_only_udm.metadata.event_timestamp |
Dipetakan dari log perubahan |
file_path |
event.idm.read_only_udm.target.process.file.full_path |
Dipetakan dari log perubahan |
api_invocations |
event.idm.read_only_udm.security_result.detection_fields |
Dipetakan dari log perubahan |
column2 |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
login time |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
syslog_priority |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
user_level |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
session_id |
event.idm.read_only_udm.network.session_id |
Dipetakan dari log perubahan |
uuid |
event.idm.read_only_udm.metadata.product_log_id |
Dipetakan dari log perubahan |
Hostname |
event.idm.read_only_udm.principal.hostname |
Dipetakan dari log perubahan |
Hostname |
event.idm.read_only_udm.principal.asset.hostname |
Dipetakan dari log perubahan |
msg |
event.idm.read_only_udm.metadata.description |
Dipetakan dari log perubahan |
Originator |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
sub |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
opID |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
progress |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
cls_simple_activity |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
certVerificationStatus |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
itemType |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
vpxd |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
securityCompliance |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
logtype |
event.idm.read_only_udm.additional.fields |
Dipetakan dari log perubahan |
severity |
event.idm.read_only_udm.security_result.severity_details |
Dipetakan dari log perubahan |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.