Questo documento descrive come disabilitare l'API Cloud Monitoring per un progetto Google Cloud e come impedire a Ops Agent e all'agente Monitoring legacy di raccogliere le metriche di processo. Ti consigliamo di disabilitare l'API Cloud Monitoring, ad esempio, se vuoi impedire l'importazione di metriche addebitabili in un progetto Google Cloud.
Disabilita la raccolta di tutte le metriche
Per impedire la raccolta di tutte le metriche, disabilita l'API Cloud Monitoring:
Console
Nella console Google Cloud, seleziona il progetto Google Cloud, quindi vai alla pagina API e servizi:
Seleziona API Cloud Monitoring.
Fai clic su Disabilita API.
gcloud
Esegui questo comando per disabilitare l'API Cloud Monitoring nel progetto attuale:
gcloud services disable monitoring.googleapis.com
Per informazioni su come disabilitare un'API utilizzando Google Cloud CLI, consulta Attivazione e disattivazione dei servizi.
Disabilita la raccolta di metriche dei processi
Esistono diversi modi per disabilitare la raccolta di queste metriche da parte di Ops Agent (versioni 2.0.0 e successive) e dell'agente Monitoring legacy su Linux.
Gli agenti vengono eseguiti solo sulle VM di Compute Engine e, per l'agente Monitoring, sulle VM Amazon Elastic Compute Cloud (EC2); queste procedure si applicano solo a queste piattaforme.
Non puoi disabilitare la raccolta da parte di Ops Agent se esegui versioni precedenti alla 2.0.0 o all'agente Monitoring legacy su Windows. Se vuoi disabilitare la raccolta di queste metriche su Windows, ti consigliamo di eseguire l'upgrade a Ops Agent versione 2.0.0 o successiva. Per ulteriori informazioni, consulta la sezione Installazione di Ops Agent.
La procedura generale è la seguente:
Connettiti alla VM.
Crea una copia del file di configurazione esistente come backup. Archivia la copia di backup al di fuori della directory di configurazione dell'agente, in modo che non tenti di caricare entrambi i file. Ad esempio, il seguente comando crea una copia del file di configurazione per l'agente Monitoring su Linux:
cp /etc/stackdriver/collectd.conf BACKUP_DIR/collectd.conf.bak
Modifica la configurazione utilizzando una delle opzioni descritte di seguito:
Riavvia l'agente per recuperare la nuova configurazione:
- Agente Monitoring:
sudo service stackdriver-agent restart
- Agente operativo:
sudo service google-cloud-ops-agent restart
- Agente Monitoring:
Verifica che le metriche di processo non vengano più raccolte per questa VM:
Seleziona Metrics Explorer.
Fai clic su MQL.
Per una risorsa
gce_instance
, inserisci la query seguente, sostituendo VM_NAME con il nome di questa VM:fetch gce_instance | metric 'agent.googleapis.com/processes/cpu_time' | filter (metadata.system_labels.name == 'VM_NAME') | align rate(1m) | every 1m
Per una risorsa
aws_ec2_instance
, sostituiscigce_instance
nella query.Fai clic su Esegui query.
Ops Agent su Linux o Windows
La posizione del file di configurazione per Ops Agent dipende dal sistema operativo:
- Per Linux:
/etc/google-cloud-ops-agent/config.yaml
- Per Windows:
C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml
Per disabilitare la raccolta di tutte le metriche di processo da parte di Ops Agent, aggiungi quanto segue al file config.yaml
:
metrics: processors: metrics_filter: type: exclude_metrics metrics_pattern: - agent.googleapis.com/processes/*
Ciò esclude le metriche di processo dalla raccolta nel processore metrics_filter
che si applica alla pipeline predefinita nel servizio metrics
.
Per saperne di più sulle opzioni di configurazione per Ops Agent, consulta Configurazione di Ops Agent.
Agente Monitoring su Linux
Per disabilitare la raccolta di metriche di processo con l'agente Monitoring legacy hai a disposizione le seguenti opzioni:
Le seguenti sezioni descrivono ciascuna opzione ed elencano i vantaggi e i rischi associati a tale opzione.
Modifica il file di configurazione dell'agente
Con questa opzione, puoi modificare direttamente il file di configurazione principale dell'agente, /etc/stackdriver/collectd.conf
, per rimuovere le sezioni che consentono la raccolta delle metriche di processo.
Procedura
Devi eseguire tre gruppi di eliminazioni nel file collectd.conf
:
Elimina la seguente istruzione
LoadPlugin
e configurazione plug-in:LoadPlugin processes <Plugin "processes"> ProcessMatch "all" ".*" Detail "ps_cputime" Detail "ps_disk_octets" Detail "ps_rss" Detail "ps_vm" </Plugin>
Elimina la seguente istruzione
PostCacheChain
e la configurazione della catenaPostCache
:PostCacheChain "PostCache" <Chain "PostCache"> <Rule "processes"> <Match "regex"> Plugin "^processes$" Type "^(ps_cputime|disk_octets|ps_rss|ps_vm)$" </Match> <Target "jump"> Chain "MaybeThrottleProcesses" </Target> Target "stop" </Rule> <Rule "otherwise"> <Match "throttle_metadata_keys"> OKToThrottle false HighWaterMark 5700000000 # 950M * 6 LowWaterMark 4800000000 # 800M * 6 </Match> <Target "write"> Plugin "write_gcm" </Target> </Rule> </Chain>
Elimina la catena
MaybeThrottleProcesses
utilizzata dalla catenaPostCache
:<Chain "MaybeThrottleProcesses"> <Rule "default"> <Match "throttle_metadata_keys"> OKToThrottle true TrackedMetadata "processes:pid" TrackedMetadata "processes:command" TrackedMetadata "processes:command_line" TrackedMetadata "processes:owner" </Match> <Target "write"> Plugin "write_gcm" </Target> </Rule> </Chain>
Vantaggi e rischi
- Vantaggi
- Riduci il numero di risorse utilizzate dall'agente, poiché le metriche non vengono mai raccolte.
- Se hai apportato altre modifiche al file
collectd.conf
, potresti riuscire a mantenerle facilmente.
- Rischi
- Per modificare questo file di configurazione, devi utilizzare l'account
root
. - Rischi di introdurre errori tipografici nel file.
- Per modificare questo file di configurazione, devi utilizzare l'account
Sostituisci il file di configurazione dell'agente
Con questa opzione, sostituisci il file di configurazione principale dell'agente con una versione pre-modificata in cui le sezioni pertinenti vengono rimosse.
Procedura
Scarica il file pre-modificato,
collectd-no-process-metrics.conf
, dal repository GitHub alla directory/tmp
, quindi procedi nel seguente modo:cd /tmp && curl -sSO https://raw.githubusercontent.com/Stackdriver/agent-packaging/master/collectd-no-process-metrics.conf
Sostituisci il file
collectd.conf
esistente con il file pre-modificato:cp /tmp/collectd-no-process-metrics.conf /etc/stackdriver/collectd.conf
Vantaggi e rischi
- Vantaggi
- Riduci le risorse utilizzate dall'agente perché le metriche non vengono mai raccolte.
- Non è necessario modificare manualmente il file come
root
. - Gli strumenti di gestione della configurazione possono sostituire facilmente un file.
- Rischi
- Se hai apportato altre modifiche al file
collectd.conf
, devi unirle nel file sostitutivo.
- Se hai apportato altre modifiche al file
Risoluzione dei problemi
Le procedure descritte in questo documento riguardano modifiche alla configurazione dell'agente, pertanto molto probabilmente si verificano i seguenti problemi:
- Privilegi insufficienti per modificare i file di configurazione. I file di configurazione devono essere modificati dall'account
root
. - Introduzione degli errori tipografici nel file di configurazione, se lo modifichi direttamente.
Per informazioni sulla risoluzione di altri problemi, consulta la sezione Risoluzione dei problemi dell'agente Monitoring.
Agente Monitoring su Windows
Non puoi disabilitare la raccolta di metriche di processo da parte dell'agente Monitoring legacy in esecuzione sulle VM Windows. Questo agente non è configurabile. Se vuoi disabilitare la raccolta di queste metriche su Windows, ti consigliamo di eseguire l'upgrade a Ops Agent versione 2.0.0 o successiva. Per ulteriori informazioni, consulta la sezione Installazione di Ops Agent.
Se esegui Ops Agent, consulta Ops Agent su Linux o Windows.