Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve como listar clusters do AlloyDB para PostgreSQL no seu projeto e conferir informações sobre eles.
A página Clusters do console do Google Cloud mostra cards de resumo e uma tabela de recursos com informações sobre todos os clusters em um projeto.
Os cards de resumo a seguir oferecem uma visão geral da integridade e do desempenho do banco de dados:
Desempenho. Mostra o número de clusters que estão nos limites de desempenho para utilização da CPU, capacidade de conexões e atraso de replicação.
Backups Mostra o número de clusters sem uma política de backup automático e o número de clusters em que o backup mais recente criado com sucesso tem mais de 24 horas, incluindo clusters sem backups.
A tabela de recursos oferece uma lista de clusters, instâncias e detalhes deles. Para
mais informações sobre como filtrar a tabela de recursos, consulte Filtrar a tabela de recursos.
Cada card de resumo mostra várias métricas em que você pode clicar para filtrar a tabela de recursos. Por exemplo, ao clicar em Nenhum backup em 24 horas no card de resumo Backups, a tabela de recursos filtra as informações para mostrar apenas os clusters cujos backups não foram feitos nas últimas 24 horas.
Para conferir a lista de clusters em todas as regiões, execute o seguinte comando:
gcloud alloydb clusters list \
--project=PROJECT_ID
Substitua PROJECT_ID pelo ID do seu projeto.
Ver a lista de clusters em uma região específica
Para conferir a lista de clusters em uma região específica, execute o seguinte comando:
gcloud alloydb clusters list \
--region=REGION_ID \
--project=PROJECT_ID
Substitua:
REGION_ID: a região cujos clusters você quer listar.
PROJECT_ID: o ID do seu projeto.
Filtrar a tabela de recursos
Por padrão, a tabela de recursos lista todos os clusters, instâncias e detalhes deles.
É possível filtrar a tabela de recursos usando os cards de resumo ou a lista Filtrar na tabela de recursos.
Para filtrar a tabela de recursos, siga estas etapas:
No console Google Cloud , acesse a página Clusters.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[[["\u003cp\u003eThis page outlines how to view and manage AlloyDB for PostgreSQL clusters within a Google Cloud project using the Google Cloud console and the \u003ccode\u003egcloud\u003c/code\u003e command-line tool.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003cstrong\u003eClusters\u003c/strong\u003e page provides an overview of database health and performance through summary cards, including information on performance limits and backup status.\u003c/p\u003e\n"],["\u003cp\u003eUsers can view a detailed list of clusters, instances, and their details, which can be filtered by various properties such as location, resource type, CPU usage, and backup status.\u003c/p\u003e\n"],["\u003cp\u003eBefore listing clusters, ensure your project has AlloyDB access enabled and you have the necessary IAM roles, such as \u003ccode\u003eroles/alloydb.admin\u003c/code\u003e, \u003ccode\u003eroles/owner\u003c/code\u003e, or \u003ccode\u003eroles/editor\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe list of clusters can be filtered, either by using the summary cards or by selecting properties from the \u003cstrong\u003eFilter\u003c/strong\u003e list in the resource table, including but not limited to: resource name, resource type, location, high availability, CPU%, and more.\u003c/p\u003e\n"]]],[],null,["# View the clusters in a project\n\nThis page describes how to list AlloyDB for PostgreSQL clusters in your\nproject and view information about them.\n\nThe **Clusters** page of the Google Cloud console displays summary cards and a\nresource table that provide information about all clusters in a project.\n\nThe following summary cards provide an overview of the database health and performance:\n\n- **Performance**. Displays the number of clusters that are at their performance\n limits for CPU utilization, connections capacity, and replication lag.\n\n- **Backups**. Displays the number of clusters without an automated backup\n policy and the number of clusters whose most recent successfully created backup\n is older than 24 hours, including clusters without backups.\n\nThe resource table provides a list of clusters, instances, and their details. For\nmore information about filtering the resource table, see [Filter the resource table](#filter-resource-table).\n\nEach summary card displays multiple metrics that you can click to filter the\nresource table. For example, when you click **No backups within 24h**\nin the **Backups** summary card, the resource table filters the information\nto display only clusters whose backups are not taken in the last 24 hours.\n\nBefore you begin\n----------------\n\n- The Google Cloud project you are using must have been [enabled to access AlloyDB](/alloydb/docs/project-enable-access).\n\n- You must have the `roles/monitoring.admin` role (the Monitoring Admin predefined IAM role)\n in the Google Cloud project you are using.\n\n- You must have one of these IAM roles in the Google Cloud project you are using:\n\n - `roles/alloydb.admin` (the AlloyDB Admin predefined IAM role)\n - `roles/owner` (the Owner basic IAM role)\n - `roles/editor` (the Editor basic IAM role)\n\n If you don't have any of these roles, contact your Organization Administrator\n to request access.\n\nView the list of clusters\n-------------------------\n\nYou can view the list of clusters, instances, and their details on the **Clusters**\npage. \n\n### Console\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the **Select a project** list, select a Google Cloud project.\n3. Click **Open**.\n4. To filter the resulting list of all of your project's clusters, either by location or another attribute, see [Filter the resource table](#filter-resource-table).\n\n### gcloud\n\nTo use the gcloud CLI, you can\n[install and initialize](/sdk/docs/install) the Google Cloud CLI, or you\ncan use [Cloud Shell](/shell/docs/using-cloud-shell).\nTo view the list of clusters, use the [`gcloud alloydb clusters list`](https://cloud.google.com/sdk/gcloud/reference/alloydb/clusters/list) command.\n\n#### View the list of clusters in all regions\n\nTo view the list clusters in all regions, run the following command: \n\n```\ngcloud alloydb clusters list \\\n --project=PROJECT_ID\n```\nReplace \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e with the ID of your project.\n\n#### View the list clusters in a specific region\n\nTo view the list clusters in a specific region, run the following command: \n\n```\ngcloud alloydb clusters list \\\n --region=REGION_ID \\\n --project=PROJECT_ID\n```\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e: The region whose clusters you want to list.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of your project.\n\nFilter the resource table\n-------------------------\n\nBy default, the resource table lists all clusters, instances, and their details.\nYou can filter the resource table by using the summary cards or the **Filter**\nlist in the resource table.\n\nTo filter the resource table, follow these steps:\n\n\u003cbr /\u003e\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the **Select a project** list, select a Google Cloud project.\n3. Click **Open**.\n4. In the **Clusters** page that opens, choose one of the following methods to filter the resource table view:\n - Choose a summary card displayed at the top of the page, and click a metric value in the summary card.\n - Go to the [resource table](#resource-table) that displays the list of clusters, and select properties and values of the resources from the **Filter** list.\n\n\u003cbr /\u003e\n\n### Resource table properties\n\nThe **Filter** list in the resource table provides the following properties:\n\nWhat's next\n-----------\n\n- For information about how to monitor AlloyDB instances, see [Monitor instances](/alloydb/docs/monitor-instance)."]]
