Gerenciar o acesso ao Personalized Service Health

Neste documento, discutimos como definir permissões e ativar o acesso para que você possa:

  • Confira os eventos do Personalized Service Health usando o painel do Service Health.
  • Extraia informações do Service Health usando a API Service Health.
  • Configure alertas relevantes para seus projetos.

Antes de começar

Verifique se o faturamento está ativado para o projeto do Google Cloud .

Acessar a API e o painel do Service Health

Para receber as permissões necessárias para acessar a API e o painel do Service Health, peça ao administrador para conceder a você o papel do IAM de Leitor do Personalized Service Health (roles/servicehealth.viewer) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

É possível usar os papéis e as permissões diretamente pela CLI gcloud para configurar os controles de acesso adequados. Por exemplo, é possível conceder o papel diretamente com o seguinte comando:

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member {USER|GROUP|SERVICE_ACCOUNT} \
  --role roles/servicehealth.viewer

É possível ver a política do Identity and Access Management (IAM) do projeto com o seguinte comando:

gcloud projects get-iam-policy PROJECT_ID

Como alternativa, é possível adicionar as permissões diretamente a um papel atual:

gcloud iam roles update ROLE_ID \
  --project=PROJECT_ID \
  --permissions="servicehealth.events.get,servicehealth.events.list,servicehealth.impacts.get,servicehealth.impacts.list,servicehealth.locations.get,servicehealth.locations.list,servicehealth.organizationEvents.get,servicehealth.organizationEvents.list,servicehealth.organizationImpacts.get,servicehealth.organizationImpacts.list,servicehealth.statuses.get,resourcemanager.projects.get,resourcemanager.projects.list"

Controlar o acesso aos detalhes dos recursos afetados (pré-lançamento)

As permissões servicehealth.impacts.list e servicehealth.impacts.get estão incluídas no papel predefinido de Leitor do Service Health (roles/servicehealth.viewer) e nos papéis básicos de Leitor, Editor e Proprietário (roles/viewer, roles/editor, roles/owner).

Quando uma interrupção de serviço afeta recursos específicos no seu projeto, essas permissões permitem que os principais vejam os nomes completos (assetName) e os tipos (assetType) dos recursos afetados em todo o projeto.

Se você quiser que um principal visualize eventos do Service Health no nível do projeto sem ver os nomes dos recursos afetados no projeto, crie um papel personalizado que inclua servicehealth.events.get e servicehealth.events.list, mas omita servicehealth.impacts.get e servicehealth.impacts.list:

gcloud iam roles create EVENT_ONLY_ROLE_ID --project=PROJECT_ID \
--title="Service Health Event-Only Viewer" \
--description="Grants access to Service Health project events without resource-level impact details" \
--permissions="servicehealth.events.get,servicehealth.events.list,servicehealth.locations.get,servicehealth.locations.list,servicehealth.statuses.get,resourcemanager.projects.get"

Usar APIs e serviços nos seus projetos

  1. Ative a API Service Health para o projeto.
  2. Conceda o papel de Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer).

Acessar registros e configurar alertas de registro

Faça o seguinte:

  1. Ative a API Service Health para o projeto.
  2. Receba permissões para alertas com base em registros.

Se você não quiser conceder o papel de Editor do canal de notificação do Monitoring (roles/monitoring.notificationChannelEditor), conceda o papel de Leitor do canal de notificação do Monitoring (roles/monitoring.notificationChannelViewer) para permitir que você vincule um canal de notificação a uma política de alertas.

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Ativar a API Service Health para um único projeto

Para configurar alertas e extrair informações do Service Health, é necessário ativar a API Service Health. É possível ativar a API pelo console doGoogle Cloud ou pela Google Cloud CLI.

Console

  1. Na biblioteca de APIs e serviços, acesse a API Service Health.

    Acessar a API Service Health

    Como alternativa, acesse a Biblioteca de APIs e pesquise "API Service Health".

  2. Selecione o projeto.

  3. Selecione o botão Ativar.

gcloud

  1. No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

  2. Verifique se a versão mais recente da Google Cloud CLI está instalada. Execute o seguinte comando no Cloud Shell:

      gcloud components update

  3. Crie ou selecione um novo projeto, PROJECT_ID.

    • Crie um projeto do Google Cloud :

      gcloud projects create PROJECT_ID
    • Selecione o projeto do Google Cloud que você criou:

      gcloud projects config set project PROJECT_ID
  4. Ative a API Service Health no projeto que você acabou de criar.

    gcloud services enable servicehealth.googleapis.com \
     --project PROJECT_ID
    

Script

Use um script para ativar a API Service Health para projetos na sua organização ou pasta.

A API Service Health e os alertas vão reconhecer novos eventos algumas horas após a ativação da API.