In questa pagina viene descritto come visualizzare le informazioni su un'istanza Cloud SQL.
Visualizza le informazioni di riepilogo dell'istanza
Puoi visualizzare le informazioni di riepilogo sulle istanze Cloud SQL utilizzando la console Google Cloud , gcloud CLI o l'API.
Console
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
Vengono visualizzate le seguenti informazioni sulle istanze Cloud SQL per cui è abilitato Private Service Connect:
- Metodo di connessione interna: indica se per connettersi all'istanza viene utilizzato Private Service Connect o l'accesso privato ai servizi
- Indirizzo IP privato: gli indirizzi IP degli endpoint Private Service Connect nella rete VPC che si connettono al collegamento al servizio dell'istanza
- Nome DNS: il nome DNS dell'istanza
Per visualizzare lo stato attuale dell'istanza, tieni il puntatore sopra l'icona di stato accanto al nome di un'istanza.
Se l'istanza è in stato
FAILEDoMAINTENANCE, puoi recuperarla selezionando un'ora nel passato e ripristinandola allo stato in cui si trovava in quel momento.Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Nella scheda Connettiti a questa istanza vengono visualizzate le seguenti informazioni aggiuntive sulle istanze Cloud SQL con Private Service Connect abilitato:
- Connettività IP privato: lo stato è Abilitato perché l'istanza deve avere un indirizzo IP interno
- Progetti consentiti: questi progetti consentono le connessioni dagli endpoint Private Service Connect all'istanza
- Collegamento al servizio: il collegamento al servizio dell'istanza
- Connettività IP pubblico: lo stato è Disabilitato perché le connessioni IP esterne non sono supportate
Per visualizzare le informazioni sulla connettività dell'istanza, tra cui se all'istanza è stato aggiunto un indirizzo IP interno o esterno, eventuali reti autorizzate associate all'istanza e se altri servizi Google Cloud , come BigQuery, possono accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione interna, fai clic sulla scheda Connessioni.
Per saperne di più su questa scheda, consulta Informazioni sulle opzioni di connessione.
Fai clic sulla scheda Networking. Vengono visualizzate le seguenti informazioni sulle istanze per cui è abilitato Private Service Connect:
- La casella di controllo IP privato è selezionata, ma disattivata. L'istanza deve avere un indirizzo IP interno e questa impostazione non può essere modificata.
- I progetti consentiti per l'istanza.
- La casella di controllo IP pubblico è selezionata, ma disattivata.
- Il campo Reti autorizzate è disattivato perché l'istanza utilizza Private Service Connect, che non supporta questa funzionalità.
gcloud
Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza Cloud Shell.
Per visualizzare le informazioni di riepilogo su un'istanza, utilizza il comando
gcloud sql instances describe:gcloud sql instances describe INSTANCE_NAME \ --project=PROJECT_ID
Effettua le seguenti sostituzioni:
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
Ecco un esempio di output per l'esecuzione di questo comando:
gcloud sql instances describe myinstance \ --project=12345 ... dnsName: mydnsname ... pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment ... settings: ... ipConfiguration: ipv4Enabled: false pscConfig: allowedConsumerProjects: - projects/23456 - projects/34567 pscEnabled: true
- Per visualizzare informazioni più dettagliate sulle istanze per cui è abilitato Private Service Connect, aggiungi i seguenti parametri:
| Impostazione | Parametro | Note |
|---|---|---|
| Nome DNS | dnsName |
Il nome DNS dell'istanza. Ti consigliamo di creare un record DNS con questo nome e di indirizzarlo all'indirizzo IP dell'endpoint Private Service Connect. Ti consigliamo inoltre di utilizzare questo nome per connetterti all'istanza. |
| Collegamento servizio | pscServiceAttachmentLink |
L'URI che rimanda al collegamento al servizio dell'istanza. Utilizza questo URI per creare l'endpoint Private Service Connect. |
| Progetti consumer consentiti | allowedConsumerProjects |
Un elenco dei progetti consentiti per l'istanza. Puoi creare endpoint Private Service Connect da qualsiasi rete VPC di questi progetti al collegamento al servizio dell'istanza. |
| Abilitazione di Private Service Connect | pscEnabled |
Se per un'istanza è abilitato Private Service Connect. |
REST v1
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "POSTGRES_13",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-custom-2-7680",
"kind": "sql#settings",
"availabilityType": "REGIONAL",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"pscConfig": {
"allowedConsumerProjects": [
"ALLOWED_PROJECTS"
],
"pscEnabled": true
},
"ipv4Enabled": false
},
...
"createTime": "2023-06-14T18:48:34.975Z",
"sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
"pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
"dnsName": "DNS_NAME"
}
I seguenti campi esistono per le istanze per cui è abilitato Private Service Connect:
allowedConsumerProjects: un elenco dei progetti consentiti per l'istanza. Puoi creare endpoint Private Service Connect da qualsiasi rete VPC in questi progetti al collegamento al servizio dell'istanza.pscEnabled: indica se per un'istanza è abilitato Private Service Connect.pscServiceAttachmentLink: l'URI che punta al collegamento al servizio dell'istanza. Utilizza questo URI per creare l'endpoint Private Service Connect.dnsName: il nome DNS dell'istanza. Ti consigliamo di creare un record DNS con questo nome e di indirizzarlo all'indirizzo IP dell'endpoint Private Service Connect. Ti consigliamo inoltre di utilizzare questo nome per connetterti all'istanza.
Per scoprire come creare la richiesta API REST sottostante per questa attività, consulta la pagina instances:get.
REST v1beta4
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "POSTGRES_13",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-custom-2-7680",
"kind": "sql#settings",
"availabilityType": "REGIONAL",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"pscConfig": {
"allowedConsumerProjects": [
"ALLOWED_PROJECTS"
],
"pscEnabled": true
},
"ipv4Enabled": false
},
...
"createTime": "2023-06-14T18:48:34.975Z",
"sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
"pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
"dnsName": "DNS_NAME"
}
I seguenti campi esistono per le istanze per cui è abilitato Private Service Connect:
allowedConsumerProjects: un elenco dei progetti consentiti per l'istanza. Puoi creare endpoint Private Service Connect da qualsiasi rete VPC in questi progetti al collegamento al servizio dell'istanza.pscEnabled: indica se per un'istanza è abilitato Private Service Connect.pscServiceAttachmentLink: l'URI che punta al collegamento al servizio dell'istanza. Utilizza questo URI per creare l'endpoint Private Service Connect.dnsName: il nome DNS dell'istanza. Ti consigliamo di creare un record DNS con questo nome e di indirizzarlo all'indirizzo IP dell'endpoint Private Service Connect. Ti consigliamo inoltre di utilizzare questo nome per connetterti all'istanza.
Nella parte superiore potresti visualizzare alcuni banner che suggeriscono azioni che potresti voler intraprendere.
Visualizza l'endpoint di scrittura
Un endpoint di scrittura è un nome DNS (Domain Name Service) globale che si risolve automaticamente nell'indirizzo IP dell'istanza principale attuale. Questo endpoint reindirizza automaticamente le connessioni in entrata alla nuova istanza principale in caso di operazione di failover o switchover della replica. Puoi utilizzare l'endpoint di scrittura in una stringa di connessione SQL anziché un indirizzo IP. Utilizzando un endpoint di scrittura, puoi evitare di dover apportare modifiche alla connessione dell'applicazione quando si verifica un'interruzione in una regione.
Per saperne di più sull'utilizzo di un endpoint di scrittura per connetterti a un'istanza, consulta Connettiti a un'istanza utilizzando un endpoint di scrittura.
Metriche
Questa sezione fornisce grafici di utilizzo delle metriche chiave delle istanze che puoi utilizzare per monitorare le tue istanze. Quando lavori con i dati delle metriche, tieni presente quanto segue:
- Un punto dati per una metrica è un'aggregazione di tutti i database ospitati dall'istanza.
- I dati vengono registrati nell'ora locale.
- I grafici visualizzati non vengono aggiornati automaticamente. Per visualizzare i nuovi dati, devi aggiornare la pagina.
- C'è un ritardo di alcuni minuti tra la registrazione dei dati delle metriche e la loro visualizzazione nei grafici di utilizzo.
Per saperne di più sulle metriche mostrate nel grafico, consulta Monitoraggio delle istanze Cloud SQL.
Per un elenco completo delle metriche di Cloud SQL fornite da Cloud Monitoring, consulta l'elenco delle metriche di Cloud SQL.
Per saperne di più sull'utilizzo di Cloud Monitoring con Google Cloud, consulta la documentazione di Cloud Monitoring.
Connetti a questa istanza
Nella sezione Connettiti a questa istanza, puoi trovare gli indirizzi IP, la rete VPC e il nome della connessione dell'istanza.
Per aprire un terminale e connetterti all'istanza, fai clic su Connettiti utilizzando Cloud Shell.
Per aprire un tutorial correlato nel riquadro a destra, fai clic su Connettiti da un'istanza VM di Compute Engine.
Per andare a Opzioni di connessione, fai clic su Visualizza tutti i metodi di connessione.
Per saperne di più sulla connessione a un'istanza, consulta Panoramica della connessione.
Service account
Questa sezione mostra l'indirizzo email del account di servizio dell'istanza.
Per saperne di più, consulta la documentazione relativa ai service account IAM.
Configurazione
Questa sezione mostra le impostazioni di configurazione correnti dell'istanza.
Per modificare le impostazioni di configurazione, fai clic su Modifica configurazione.
Per saperne di più sulla modifica della configurazione dell'istanza, consulta Modifica di un'istanza.
Operazioni e log
Questa sezione elenca le operazioni recenti sull'istanza, ad esempio la creazione di backup.
Per visualizzare le operazioni recenti, fai clic su Visualizza tutte le operazioni.
Per visualizzare le informazioni di logging, fai clic su Visualizza i log degli errori di PostgreSQL.
Per saperne di più sulle pagine Operazioni ed Esplora log, consulta Logging di Cloud SQL.
Per informazioni generali sul logging, consulta Visualizzazione dei log ed Esportazione dei log.
Manutenzione
Questa sezione mostra le impostazioni e la pianificazione correnti degli aggiornamenti di manutenzione.
Per modificare le preferenze, fai clic su Modifica le preferenze di manutenzione.
Per modificare le impostazioni di notifica, fai clic su Modifica preferenze di notifica.
Per saperne di più sulla manutenzione in Cloud SQL, consulta la panoramica della manutenzione.
Passaggi successivi
- Scopri di più sulle metriche di Cloud Monitoring per Cloud SQL.
- Scopri di più sulle impostazioni per le istanze.
- Scopri di più sulla modifica di un'istanza.