O Serviço Gerenciado para Apache Kafka permite visualizar o status de funcionamento, a alocação de recursos e os detalhes de configuração de todos os clusters do Connect. Essa visualização consolidada ajuda você a gerenciar seus clusters do Connect em um só lugar.
Para listar os clusters do Connect, use o Google Cloud console, a CLI gcloud, a biblioteca de cliente ou a API Managed Kafka. Não é possível usar a API Apache Kafka de código aberto para listar clusters do Connect.
Papéis e permissões necessários para listar os clusters do Connect
Para receber as permissões necessárias para listar os clusters do Connect, peça ao administrador para conceder a você o papel do IAM de Leitor do Kafka gerenciado (roles/managedkafka.viewer) no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém as permissões necessárias para listar os clusters do Connect. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para listar os clusters do Connect:
-
Conceda a permissão de listar clusters no local especificado:
managedkafka.connectClusters.list -
Conceda a permissão para receber detalhes do cluster no local especificado:
managedkafka.connectClusters.get
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Ver os clusters do Connect
Console
No console do Google Cloud , acesse a página Clusters do Connect.
Os clusters que você criou em um projeto são listados. A página permite visualizar as seguintes propriedades do cluster:
- Nome: o identificador exclusivo do cluster do Connect. É possível usá-lo para referenciar o cluster do Connect em várias operações.
- Estado: indica o status de funcionamento atual do cluster do Connect, como Ativo.
- Localização: a localização geográfica em que o cluster do Connect está hospedado.
- Horário de atualização: o horário em que o cluster do Connect foi atualizado pela última vez.
- vCPUs: o número de vCPUs atribuídas ao cluster do Connect.
- Memória: a quantidade total de alocação de memória para o cluster do Connect.
- Cluster principal do Kafka: o cluster do Serviço Gerenciado para Apache Kafka associado ao cluster do Connect.
- Rótulos: pares de chave-valor que podem ser anexados ao cluster do Connect para fins de organização, filtragem e automação.
gcloud
-
No console do Google Cloud , ative o Cloud Shell.
Na parte inferior do console do Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Use o comando
gcloud managed-kafka connect-clusters listpara listar os clusters do Connect:gcloud managed-kafka connect-clusters list \ --location=LOCATIONPara refinar ainda mais a lista de clusters do Connect, use outras flags:
gcloud managed-kafka connect-clusters list \ --location=LOCATION \ [--filter=EXPRESSION] \ [--limit=LIMIT] \ [--page-size=PAGE_SIZE] \ [--sort-by=SORT_BY]Substitua:
LOCATION: obrigatório. O local dos clusters do Connect que você quer listar.
EXPRESSION: (opcional) uma expressão de filtro booleano a ser aplicada à lista. Se a expressão for avaliada como
True, o item será incluído na lista. Para mais detalhes e exemplos, executegcloud topic filters.LIMIT: (opcional) o número máximo de clusters do Connect a serem exibidos. Se não for especificado, todos os clusters do Connect serão listados.
PAGE_SIZE: (opcional) o número de resultados a serem exibidos por página. Se não for especificado, o serviço vai determinar um tamanho de página adequado.
SORT_BY: (opcional) uma lista separada por vírgulas de campos para usar na ordenação. A ordem de classificação padrão é crescente. Para classificar em ordem decrescente, adicione o prefixo
~ao campo.
Exemplo de saída:
NAME VCPU MEMORY_BYTES STATE NETWORK
connect-cluster-alpha 3 3221225472 ACTIVE
connect-cluster-beta 3 3221225472 ACTIVE
Go
Antes de testar esta amostra, siga as instruções de configuração do Go em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do Serviço Gerenciado para Apache Kafka.
Para autenticar no Serviço Gerenciado para Apache Kafka, configure o Application Default Credentials(ADC). Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do Serviço Gerenciado para Apache Kafka.
Para autenticar no Serviço Gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Python
Antes de testar este exemplo, siga as instruções de configuração do Python em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do Serviço Gerenciado para Apache Kafka.
Para autenticar no Serviço Gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.