Questo documento descrive come creare ed eseguire un job batch che installa automaticamente Ops Agent. Installa Ops Agent per fornire metriche aggiuntive in Cloud Monitoring sulle prestazioni delle risorse di un job. Per saperne di più sull'utilizzo delle metriche sulle prestazioni delle risorse per un job, consulta Monitorare e ottimizzare le risorse dei job visualizzando le metriche.
Prima di iniziare
- Se non hai mai utilizzato Batch, consulta la guida Inizia a utilizzare Batch e abilita Batch completando i prerequisiti per progetti e utenti.
- Se non l'hai ancora fatto, abilita le API Cloud Monitoring e Cloud Logging per il tuo progetto:
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (
roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazioneserviceusage.services.enable. Scopri come concedere i ruoli. -
Per ottenere le autorizzazioni necessarie per creare un job, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Per creare un job:
-
Editor di job batch (
roles/batch.jobsEditor) sul progetto -
Utente account di servizio (
roles/iam.serviceAccountUser) sul service account del job, che per impostazione predefinita è il service account predefinito di Compute Engine
-
Editor di job batch (
-
Per visualizzare i log:
Visualizzatore log (
roles/logging.viewer) sul progetto
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
-
Per creare un job:
A meno che tu non stia utilizzando la configurazione predefinita per il service account del job, assicurati che disponga delle autorizzazioni necessarie.
Per assicurarti che il account di servizio del job disponga delle autorizzazioni necessarie per scrivere le metriche di Ops Agent in Monitoring, chiedi all'amministratore di concedere i seguenti ruoli IAM al account di servizio del job:
-
Monitoring Metric Writer (
roles/monitoring.metricWriter) on the project -
Logs Writer (
roles/logging.logWriter) sul progetto
-
Monitoring Metric Writer (
- Assicurati che la configurazione del job pianificata soddisfi i requisiti di Ops Agent.
Requisiti di Ops Agent
Per creare ed eseguire un job che utilizza Ops Agent, il job deve soddisfare tutti i seguenti requisiti:
Assicurati che le VM del job utilizzino un sistema operativo (OS) supportato da Ops Agent. Per saperne di più sull'immagine del sistema operativo della VM per un job, consulta Panoramica dell'ambiente del sistema operativo per le VM di un job.
Se il job utilizza una configurazione di rete non predefinita o utilizza Controlli di servizio VPC, assicurati che soddisfi i requisiti di accesso per Ops Agent. Per saperne di più, consulta VM senza accesso ai pacchetti remoti nella documentazione di Google Cloud Observability.
Assicurati che il job non installi un agente Cloud Logging o Cloud Monitoring legacy, ad esempio tramite un'immagine personalizzata o un modello di istanza.
Per saperne di più sulle funzionalità e sui requisiti di Ops Agent, consulta la panoramica di Ops Agent nella documentazione di Google Cloud Observability.
Creare un job che installa automaticamente Ops Agent
Utilizza Google Cloud CLI o l'API REST per
creare un job che
includa il
installOpsAgent campo
impostato su true nel campo allocationPolicy.instances nel corpo principale del
file JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Ad esempio, un job che installa automaticamente Ops Agent può avere un file di configurazione JSON simile al seguente:
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Dopo l'avvio delle VM del job, puoi visualizzare le metriche di Ops Agent come qualsiasi altra metrica delle risorse. Per saperne di più, consulta Monitorare e ottimizzare le risorse dei job visualizzando le metriche.
Passaggi successivi
- Se riscontri problemi durante la creazione o l'esecuzione di un job, consulta Risoluzione dei problemi.
- Visualizza job e attività.
- Scopri di più sulle opzioni di creazione dei job .