Visualizzazione delle informazioni sull'istanza

MySQL | PostgreSQL | SQL Server

Questa pagina descrive come visualizzare le informazioni su un'istanza Cloud SQL.

Visualizza informazioni di riepilogo dell'istanza

Puoi visualizzare 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.

Vai a Istanze Cloud SQL

Vengono visualizzate le seguenti informazioni sulle istanze Cloud SQL in cui è abilitato Private Service Connect:
- Metodo di connessione interna : indica se viene utilizzato Private Service Connect o l'accesso privato ai servizi per la connessione all'istanza
- 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 premuto il puntatore sull'icona di stato accanto al nome di un'istanza.

Se l'istanza è in stato FAILED o MAINTENANCE, puoi clonarla selezionando una data/ora passata e ripristinando l'istanza corrispondente a quella data/ora.
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.

Nella scheda Connetti a questa istanza, vengono visualizzate le seguenti informazioni aggiuntive sulle istanze Cloud SQL in cui è abilitato Private Service Connect:
- Connettività IP privato:lo stato è Abilitata 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 con IP esterno non sono supportate
Per visualizzare le informazioni sulla connettività dell'istanza, ad esempio se all'istanza viene 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 maggiori informazioni su questa scheda, consulta Informazioni sulle opzioni di connessione.
Fai clic sulla scheda Networking. Vengono visualizzate le seguenti informazioni sulle istanze in cui Private Service Connect è abilitato:
- 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, vedi Utilizzare 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 Private Service Connect nelle reti VPC potranno connettersi all'istanza.
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
Ecco un esempio dell'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 in cui Private Service Connect è abilitato, aggiungi i seguenti parametri:

Impostazione	Parametro	Note
Nome DNS	`dnsName`	Il nome DNS per l'istanza. Ti consigliamo di creare un record DNS con questo nome e di puntarlo 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 in questi progetti al collegamento al servizio dell'istanza.
Abilitazione di Private Service Connect	`pscEnabled`	Indica se per un'istanza è abilitato Private Service Connect.

Terraform

Per creare un'istanza, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle sezioni seguenti.

prepara Cloud Shell

Avvia Cloud Shell.
Imposta il progetto Google Cloud predefinito a cui vuoi applicare le configurazioni Terraform.

Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Se imposti valori espliciti nel file di configurazione Terraform, le variabili di ambiente vengono sostituite.

Prepara la directory

Ogni file di configurazione Terraform deve avere una propria directory (detta anche modulo principale).

In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome del file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è indicato come main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

Copia il codice campione nel file main.tf appena creato.

Se vuoi, copia il codice da GitHub. Questa opzione è consigliata se lo snippet Terraform fa parte di una soluzione end-to-end.
Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
Salva le modifiche.
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
```
terraform init
```
Facoltativamente, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:
```
terraform init -upgrade
```

Applica le modifiche

Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:
```
terraform plan
```
Apporta le correzioni necessarie alla configurazione.
Applica la configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt:
```
terraform apply
```
Attendi finché Terraform non visualizza il messaggio "Applicazione completata".
Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

Per disabilitare la protezione dall'eliminazione, nel file di configurazione Terraform imposta l'argomento deletion_protection su false.
```
deletion_protection =  "false"
```
Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo yes al prompt:
```
terraform apply
```

Rimuovi le risorse applicate in precedenza con la tua configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt:
```
terraform destroy
```

REST v1

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

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 Private Service Connect nelle reti VPC potranno 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:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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 in cui Private Service Connect è abilitato:

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 puntarlo 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 dell'API REST sottostante per questa attività, consulta la pagina instances:get.

REST v1beta4

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

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 Private Service Connect nelle reti VPC potranno 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:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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 in cui Private Service Connect è abilitato:

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 puntarlo 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 dell'API REST sottostante per questa attività, consulta la pagina instances:get.

Potresti vedere alcuni banner in alto che suggeriscono azioni da intraprendere.

Metriche

Questa sezione fornisce grafici sull'utilizzo delle metriche principali delle istanze che puoi usare per monitorare le istanze. Quando lavori con i dati delle metriche, tieni presente quanto segue:

Un punto dati per una metrica è un aggregato relativo a tutti i database ospitati dall'istanza.
I dati sono riportati nell'ora locale.
I grafici visualizzati non si aggiornano automaticamente; per visualizzare nuovi dati, devi aggiornare la pagina.
Esiste un ritardo di alcuni minuti tra la registrazione dei dati delle metriche e il momento in cui vengono visualizzati nei grafici sull'utilizzo.

Per ulteriori informazioni 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 ulteriori informazioni sull'utilizzo di Cloud Monitoring con Google Cloud, consulta la documentazione di Cloud Monitoring.

Connetti a questa istanza

Nella sezione Connetti 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 Connetti tramite Cloud Shell.

Per aprire un tutorial correlato nel riquadro a destra, fai clic su Connetti da un'istanza VM di Compute Engine.

Per andare a Opzioni di connessione, fai clic su Visualizza tutti i metodi di connessione.

Per ulteriori informazioni sulla connessione a un'istanza, consulta la pagina Panoramica della connessione.

Account di servizio

Questa sezione mostra l'indirizzo email dell'account di servizio dell'istanza.

Per ulteriori informazioni, consulta la documentazione relativa agli account di servizio IAM.

Configurazione

Questa sezione mostra le impostazioni di configurazione attuali dell'istanza.

Per modificare le impostazioni di configurazione, fai clic su Modifica configurazione.

Per ulteriori informazioni sulla modifica della configurazione dell'istanza, consulta Modifica di un'istanza.

Operazioni e log

Questa sezione elenca le operazioni recenti dell'istanza, come 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 PostgreSQL.

Per ulteriori informazioni sulle pagine Operazioni ed Esplora log, consulta Logging di Cloud SQL.

Per informazioni generiche sul logging, consulta Visualizzazione dei log ed Esportazione dei log.

Manutenzione

Questa sezione mostra le impostazioni e la pianificazione dell'aggiornamento di manutenzione attuali.

Per modificare le preferenze, fai clic su Modifica preferenze di manutenzione.

Per modificare le impostazioni di notifica, fai clic su Modifica preferenze di notifica.

Per ulteriori informazioni sulla manutenzione in Cloud SQL, consulta 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.