Profilazione delle applicazioni in esecuzione al di fuori di Google Cloud
Questa pagina descrive come profilare le applicazioni in esecuzione al di fuori di Google Cloud.
In questo scenario, l'applicazione e l'agente Cloud Profiler vengono eseguiti al di fuori di Google Cloud, ma utilizzerai l'interfaccia di Cloud Profiler per analizzare i dati di profilazione.
L'uso dell'interfaccia Profiler per analizzare i dati di profilazione richiede un progetto Google Cloud. L'agente di profilazione in esecuzione altrove deve essere in grado di inviare i profili per l'analisi. Per attivarlo, devi:
- Creare un progetto Google Cloud e abilitare l'API.
- Ottieni le credenziali dell'agente di profilazione da utilizzare durante il caricamento dei profili.
- Configura l'agente in modo che utilizzi le credenziali e l'ID del progetto Google Cloud.
Creare un progetto Google Cloud
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
Abilita l'API Profiler
-
Attiva l'API richiesta.
Se viene visualizzato API abilitata, l'API è già abilitata. In caso contrario, fai clic sul pulsante Attiva.
Ottieni le credenziali per l'agente
Esistono due modi per ottenere le credenziali che l'agente può utilizzare:
- Consenti all'agente di utilizzare un account di servizio con autenticazione a chiave privata
- Consenti all'agente di utilizzare le credenziali predefinite dell'applicazione (ADC).
Utilizzo degli account di servizio
Per consentire all'agente di utilizzare un account di servizio con autenticazione a chiave privata, devi:
Crea un account di servizio. Ad esempio, utilizzando Google Cloud CLI:
gcloud iam service-accounts create MY_SVC_ACCT_ID --display-name "my service account"
Per ulteriori informazioni, consulta la sezione Creazione di un account di servizio.
Concedi all'account di servizio il ruolo roles/cloudprofiler.agent in modo che possa scrivere i dati di profilazione. Ad esempio, utilizzando Google Cloud CLI:
gcloud projects add-iam-policy-binding GCP_PROJECT_ID \ --member serviceAccount:MY_SVC_ACCT_ID@GCP_PROJECT_ID.iam.gserviceaccount.com \ --role roles/cloudprofiler.agent
Per ulteriori informazioni, consulta Concessione di ruoli agli account di servizio.
Creare una chiave JSON per l'account di servizio. Ad esempio, utilizzando Google Cloud CLI:
gcloud iam service-accounts keys create \ ~/key.json \ --iam-account MY_SVC_ACCT_ID@GCP_PROJECT_ID.iam.gserviceaccount.com
Per ulteriori informazioni, consulta Creazione di chiavi degli account di servizio.
Nella macchina su cui verrà eseguito l'agente di profilazione:
- Inserisci una copia del file contenente la chiave JSON appena creata.
- Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul nome completo del file contenente la chiave JSON. Questa variabile di ambiente deve essere visibile al processo che esegue l'agente di profilazione. Pertanto, se utilizzi uno script o un Dockerfile per eseguire il processo, includi la variabile di ambiente.
Utilizzo delle credenziali predefinite dell'applicazione
Per abilitare l'agente a utilizzare le credenziali predefinite dell'applicazione, devi ottenere le credenziali di accesso degli utenti tramite un flusso web e inserirle dove sono previste dalla libreria Credenziali predefinite dell'applicazione. Queste credenziali fungono da proxy per un account di servizio.
Per utilizzare le credenziali predefinite dell'applicazione, esegui questo comando di Google Cloud CLI:
gcloud auth application-default login
e segui i passaggi indicati da questo comando.
Collegamento dell'agente a un progetto Google Cloud
L'agente di profilazione deve essere configurato in modo da specificare l'ID del progetto Google Cloud in modo che possa caricare i profili. Il meccanismo per eseguire questa operazione dipende dalla lingua.
Go
Specifica un parametro aggiuntivo, ProjectID
, nell'oggetto profiler.Config
descritto in Profilazione delle applicazioni Go:
profiler.Config{ProjectID: "GCP_PROJECT_ID", ...}
Java
Specifica un flag di configurazione dell'agente Java aggiuntivo, cprof_project_id
, per la chiamata Java:
-cprof_project_id=GCP_PROJECT_ID
Quando l'applicazione non è in grado di accedere al server dei metadati di Compute Engine, vengono visualizzati messaggi simili ai seguenti:
Error making HTTP request for 169.254.169.254:80/computeMetadata/v1/instance/zonePer interrompere questi messaggi, aggiungi
-cprof_zone_name=VALUE
ai flag di configurazione
dell'agente e riavvia l'applicazione. Per questo scenario, sostituisci VALUE
con una stringa descrittiva come "test".Node.js
Specifica un parametro aggiuntivo, projectID
, nell'oggetto serviceContext
descritto in Profilazione delle applicazioni Node.js:
projectId: 'GCP_PROJECT_ID',
serviceContext: {
...
}
Python
Specifica un parametro aggiuntivo, project_id
, nella chiamata al metodo start
descritta in Profilazione delle applicazioni Python:
googlecloudprofiler.start(..., project_id='GCP_PROJECT_ID')
Passaggi successivi
- Selezionare i profili da analizzare
- Interagire con il grafico a fiamme
- Filtrare il grafico a fiamme
- Metti a fuoco il grafico a fiamme
- Confrontare i profili