Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Como monitorar seus recursos
Para acessar informações sobre seus recursos, use kubectl.
Antes de começar
Para concluir essas etapas, você precisa dos recursos existentes do Config Connector.
Para ver um exemplo de recurso, consulte
Primeiros passos com o Config Connector.
Como listar todos os recursos
É possível listar os recursos gerenciados pelo Config Connector executando
o seguinte comando:
kubectl get gcp
Como determinar o status de um recurso
É possível determinar se o recurso está pronto analisando a
status.condition.
O Config Connector atualiza o status para refletir o estado atual do
recurso.
kubectl wait --for=condition=READY KINDNAME
Substitua:
KIND: o tipo do recurso. Por exemplo, PubSubTopic.
NAME: o nome do recurso
Como visualizar eventos
O Config Connector cria eventos do Kubernetes com informações e erros sobre
o gerenciamento de recursos. É possível visualizar os eventos de um recurso específico ou todos os eventos
no ambiente do Config Connector.
Como visualizar eventos para um único recurso
É possível visualizar os eventos de um único recurso examinando o campo Events
na saída do seguinte comando:
kubectl describe KINDNAME
Substitua:
KIND: o tipo do recurso
NAME: o nome do recurso
Por exemplo, se você tem um recurso do Config Connector SQLInstance
chamado sqlinstance-sample, use o comando a seguir para conferir os eventos:
kubectl describe sqlinstance sqlinstance-sample
Como visualizar eventos de um namespace
Para conferir os eventos de todos os recursos do Kubernetes em um determinado namespace, incluindo
os recursos do Config Connector, execute o seguinte comando:
kubectl --namespace CC_NAMESPACE get events
Substitua CC_NAMESPACE pelo namespace em que o Config Connector gerencia recursos.
Eventos específicos do Config Conector
O Config Connector pode criar os seguintes tipos de eventos:
Atualizando
Ocorre quando o recurso Google Cloud
subjacente de um recurso do Config Connector está sendo atualizado.
UpToDate
Ocorre quando a reconciliação de um recurso do Config Connector é bem-sucedida.
Esse tipo de evento significa que o recurso Google Cloud subjacente agora
corresponde ao estado desejado especificado pelo recurso do Config Connector.
UpdateFailed
Ocorre quando a reconciliação de um recurso do Config Connector falha.
DependencyNotReady
Ocorre quando um recurso do Config Connector referenciado não está pronto. É possível
determinar se um recurso está pronto verificando o
status dele.
DependencyNotFound
Ocorre quando um recurso do Config Connector ou um secret do Kubernetes
não é encontrado.
DependencyInvalid
Ocorre quando uma referência é inválida. Por exemplo, suponha que um recurso do Config Connector
faça referência a um secret do Kubernetes. Se o segredo existir, mas
não conter a chave que está sendo referenciada, a referência
será considerada inválida.
Excluindo
Ocorre quando o recurso do Config Connector está sendo excluído do servidor da API Kubernetes.
Excluído
Ocorre quando um recurso do Config Connector é excluído do
servidor da API Kubernetes.
DeleteFailed
Ocorre quando um recurso do Config Connector não pode ser excluído do
servidor da API Kubernetes.
ManagementConflict
Ocorre quando um recurso do Config Connector não consegue assumir a propriedade do
recurso Google Cloud subjacente. Quando isso ocorre, geralmente é
porque outro recurso do Config Connector já tem a propriedade do
recursoGoogle Cloud . Leia mais sobre como o Config Connector lida com conflitos entre vários recursos.
PreActuationTransformFailed
Ocorre quando um recurso do Config Connector não consegue realizar transformações antes da ativação.
Esse tipo de evento provavelmente significa que a configuração do recurso é inválida.
PostActuationTransformFailed
Ocorre quando um recurso do Config Connector não consegue realizar transformações pós-ativação.
Não gerenciado
Ocorre quando o Config Connector está no
modo com namespace
e o recurso do Config Connector está em um namespace em que ele
não está ativado, ou seja, o namespace não tem um
objeto ConfigConnectorContext.
Esse evento pode ocorrer mesmo que o namespace tenha um
ConfigConnectorContext, se o ConfigConnectorContext foi criado na mesma época que o recurso do Config Connector. Basta aguardar
algum tempo para que o Config Connector comece a gerenciar o recurso.
[[["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-11 UTC."],[[["\u003cp\u003eYou can use \u003ccode\u003ekubectl\u003c/code\u003e commands to monitor resources managed by Config Connector, including listing them with \u003ccode\u003ekubectl get gcp\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe status of a resource can be determined by examining its \u003ccode\u003estatus.condition\u003c/code\u003e and you can use \u003ccode\u003ekubectl wait --for=condition=READY\u003c/code\u003e to wait for a resource to become ready.\u003c/p\u003e\n"],["\u003cp\u003eConfig Connector generates Kubernetes events that you can view for a specific resource using \u003ccode\u003ekubectl describe KIND NAME\u003c/code\u003e, or for all resources in a namespace with \u003ccode\u003ekubectl --namespace CC_NAMESPACE get events\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eConfig Connector events, like \u003ccode\u003eUpdating\u003c/code\u003e, \u003ccode\u003eUpToDate\u003c/code\u003e, \u003ccode\u003eUpdateFailed\u003c/code\u003e, \u003ccode\u003eDependencyNotReady\u003c/code\u003e, and others, provide information about the lifecycle and state of resources.\u003c/p\u003e\n"],["\u003cp\u003eConfig Connector events, such as \u003ccode\u003eManagementConflict\u003c/code\u003e, \u003ccode\u003ePreActuationTransformFailed\u003c/code\u003e, \u003ccode\u003ePostActuationTransformFailed\u003c/code\u003e, and \u003ccode\u003eUnmanaged\u003c/code\u003e give specific data regarding certain issues with the resources.\u003c/p\u003e\n"]]],[],null,["# Monitoring your resources\n=========================\n\n*** ** * ** ***\n\nTo get information on your resources, you can use `kubectl`.\n\nBefore you begin\n----------------\n\nTo complete these steps, you need existing Config Connector resources.\nFor an example resource, see\n[Getting started with Config Connector](/config-connector/docs/how-to/getting-started).\n\nListing all resources\n---------------------\n\nYou can list the resources that Config Connector manages with, by running\nthe following command: \n\n```\nkubectl get gcp\n```\n\nDetermining a resource's status\n-------------------------------\n\nYou can determine if your resource is ready by looking at its\n[status.condition](/config-connector/docs/concepts/resources#status_condition).\nConfig Connector updates the status to reflect the current state of\nyour resource. \n\n```\nkubectl wait --for=condition=READY KIND NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eKIND\u003c/var\u003e: your resource's kind. For example, `PubSubTopic`.\n- \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e: your resource's name\n\nViewing events\n--------------\n\nConfig Connector creates Kubernetes events with information and errors about\nmanaging resources. You can view events for a specific resource, or all events\nin your Config Connector environment.\n\n### Viewing events for a single resource\n\nYou can view the events for a single resource by examining the `Events` field\nin the output of the following command: \n\n```\nkubectl describe KIND NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eKIND\u003c/var\u003e: your resource's kind\n- \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e: your resource's name\n\nFor example, if you had a Config Connector `SQLInstance` resource\nnamed `sqlinstance-sample`, use the following command to view its events: \n\n```\nkubectl describe sqlinstance sqlinstance-sample\n```\n\n### Viewing events for a namespace\n\nTo see the events for all Kubernetes resources in a given namespace, including\nyour Config Connector resources, run the following command: \n\n```\nkubectl --namespace CC_NAMESPACE get events\n```\n\nReplace \u003cvar translate=\"no\"\u003eCC_NAMESPACE\u003c/var\u003e with the namespace Config Connector\nmanages resources from.\n\n### Config Connector-specific events\n\nConfig Connector can create the following event types:\n\nUpdating\n: Occurs when a Config Connector resource's underlying Google Cloud\n resource is being updated.\n\nUpToDate\n: Occurs when a Config Connector resource's reconciliation has succeeded.\n This event type means that the underlying Google Cloud resource now\n matches the desired state specified by the Config Connector resource.\n\nUpdateFailed\n: Occurs when a Config Connector resource's reconciliation has failed.\n\nDependencyNotReady\n: Occurs when a referenced Config Connector resource is not ready. You can\n determine whether a resource is ready by [checking its\n status](#determining-resource-status).\n\nDependencyNotFound\n: Occurs when a referenced Config Connector resource or Kubernetes Secret\n is not found.\n\nDependencyInvalid\n: Occurs when a reference is invalid. For example, suppose a Config Connector\n resource that references a Kubernetes Secret. If the Secret exists, but if\n it does not contain the key that is being referenced, then the reference\n is said to be invalid.\n\nDeleting\n: Occurs when Config Connector resource is being deleted from the Kubernetes\n API Server.\n\nDeleted\n: Occurs when a Config Connector resource has successfully been deleted from\n the Kubernetes API Server.\n\nDeleteFailed\n: Occurs when a Config Connector resource has failed to be deleted from the\n Kubernetes API Server.\n\nManagementConflict\n: Occurs when a Config Connector resource fails to take ownership of the\n underlying Google Cloud resource. When this occurs, it is usually\n because another Config Connector resource already has ownership of the\n Google Cloud resource. Read more about [how Config Connector handles\n conflicts between multiple Config Connector resources](/config-connector/docs/concepts/managing-conflicts).\n\nPreActuationTransformFailed\n: Occurs when a Config Connector resource fails to perform pre-actuation transformations.\n This event type likely means that the resource configuration is invalid.\n\nPostActuationTransformFailed\n: Occurs when a Config Connector resource fails to perform post-actuation transformations.\n\nUnmanaged\n\n: Occurs when Config Connector is in\n [namespaced-mode](/config-connector/docs/how-to/install-namespaced)\n and the Config Connector resource is in a namespace where Config Connector\n is not enabled (that is, the namespace does not have a\n `ConfigConnectorContext` object).\n\n This event can occur even if the namespace does have a\n `ConfigConnectorContext` if the `ConfigConnectorContext` was created around\n the same time as the Config Connector resource. You just need to wait\n some time for Config Connector to start managing the resource.\n\nWhat's next\n-----------\n\n- Learn more about\n [Kubernetes application introspection](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-application-introspection/).\n\n- Monitor your Config Connector installation with\n [Prometheus](/config-connector/docs/how-to/monitoring-prometheus)."]]
