Definir um microsserviço

Este documento descreve como criar serviços personalizados e serviços para alguns recursos, como o GKE e o Cloud Run.

No Cloud Monitoring, um serviço é uma construção que pode associar a SLOs e políticas de alerta. Vários dos recursos para os quais pode criar serviços de monitorização também são denominados serviços, mas com significados diferentes, como serviços do GKE ou serviços do Cloud Run.

A monitorização pode reconhecer os serviços baseados no GKE e no Cloud Run como candidatos para monitorização. Para criar serviços para os mesmos, indica que candidatos quer que sejam tratados como serviços de monitorização. A monitorização cria a infraestrutura necessária para si.

Também pode definir serviços personalizados arbitrários.

Identifique ou crie um serviço

Para identificar serviços candidatos ou criar serviços personalizados, aceda ao painel Definir serviço:

  1. Na Google Cloud consola, aceda à página  SLOs:

    Aceda a SLOs

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

  2. Na página Vista geral dos serviços, faça uma das seguintes ações:

    • Clique em Definir serviço.

    • No painel Estado atual, clique no link Definir serviço:

      Crie serviços personalizados e identificados pelo utilizador através da opção **Definir serviço**.

No painel Definir serviço, pode fazer o seguinte:

  • Crie serviços a partir de uma lista de serviços candidatos.
  • Defina serviços personalizados.

As secções seguintes descrevem estas opções.

Crie serviços

O Cloud Monitoring pode identificar potenciais serviços dos seguintes tipos:

  • Serviços do Cloud Service Mesh
  • Serviços do Istio no Google Kubernetes Engine
  • Serviços do App Engine
  • Namespaces do GKE
  • Serviços do GKE
  • Cargas de trabalho do GKE
  • Serviço do Cloud Run

Uma vez que podem existir muitos destes potenciais serviços, a monitorização não assume que quer que todos sejam tratados como serviços com SLOs. Para indicar qual dos potenciais serviços o Monitoring deve tratar como serviços, use a Google Cloud consola ou a API.

Use a consola Google Cloud para criar serviços

Para criar um serviço através da Google Cloud consola, faça o seguinte:

  1. Na página Vista geral dos serviços, clique em Definir serviço.

  2. Selecione Candidatos a serviços.

    Os serviços potenciais são apresentados no separador **Candidatos a serviços**.

    Pode existir um grande número de serviços candidatos na lista. Pode filtrar a lista da seguinte forma:

    1. Clique em Filtrar tabela. É apresentada uma lista de opções de filtro.

    2. Selecione uma das opções na lista de filtros. A opção selecionada aparece na barra de filtros.

    3. Clique junto à opção na barra de filtros e comece a escrever. Os valores que correspondem são apresentados numa lista. Selecione um valor da lista.

  3. Clique num serviço candidato na lista de potenciais serviços.

    Quando clica numa entrada, os seguintes campos são preenchidos automaticamente:

    • O nome a apresentar é definido como o nome da entrada na lista. Pode alterar este valor.

    • É gerado um bloco de código JSON para a configuração do novo serviço a partir do candidato. Não altere este valor.

  4. Clique em Enviar. Quando o serviço é criado, é apresentada uma notificação de Êxito.

Use a API para criar um serviço

Também pode criar serviços através da API SLO, que faz parte da API Cloud Monitoring.

Para criar um serviço de forma programática, publique um objeto de configuração como um dos seguintes no método services.create:

Namespace do GKE

Use a estrutura GkeNamespace, por exemplo:

{
  "displayName": "test-kube-namespace",
  "gkeNamespace": {
    "location": "us-central1-c",
    "clusterName": "cluster-1",
    "namespaceName": "test-kube-namespace"
  }
}

Serviço do GKE

Use a estrutura GkeService, por exemplo:

{
  "displayName": "test-kube-service",
  "gkeService": {
    "location": "us-central1-c",
    "clusterName": "cluster-1",
    "namespaceName": "kube-system",
    "serviceName": "test-kube-service"
  }
}

Carga de trabalho do GKE

Use a estrutura GkeWorkload, por exemplo:

{
  "displayName": "frontend-a",
  "gkeWorkload": {
    "location": "us-central1-b",
    "clusterName": "cluster-2",
    "namespaceName": "default",
    "topLevelControllerType": "Deployment",
    "topLevelControllerName": "frontend-a"
  }
}

Cloud Run

Use a estrutura CloudRun, por exemplo:

{
  "displayName": "test-cloudrun-service",
  "cloudRun": {
    "serviceName": "test-cloudrun-service",
    "location": "us-central1"
  }
}

Cloud Service Mesh

Use a estrutura MeshIstio, por exemplo:

{
  "displayName": "test-mesh-istio-service",
  "meshIstio": {
    "meshUid": "mesh-identifier"
    "serviceName": "test-mesh-istio-service",
    "serviceNamespace": "default"
  }
}

Istio no GKE

Use a estrutura clusterIstio, por exemplo:

{
  "displayName": "test-cluster-istio-service",
  "clusterIstio": {
    "serviceName": "test-cloud-service",
    "clusterName": "cluster-2",
    "serviceNamespace": "default",
    "location": "us-central1"
  }
}

App Engine

Use a estrutura AppEngine, por exemplo:

{
  "displayName": "test-mesh-istio-service",
  "appEngine": {
    ""moduleId": "id-of-the-service"
  }
}

Para mais informações sobre a gestão de serviços por programação, consulte os seguintes documentos:

Crie um serviço personalizado

Quando nenhum outro tipo de serviço satisfaz as suas necessidades, crie um serviço personalizado. Com um serviço personalizado, pode agrupar arbitrariamente os SLOs de uma forma significativa para o seu ambiente ou criar SLOs em métricas empresariais que não correspondam a um microsserviço existente.

Use a Google Cloud consola para criar um serviço personalizado

Para definir um serviço personalizado através da Google Cloud consola, faça o seguinte:

  1. Clique em Definir serviço na página Vista geral dos serviços para apresentar o painel Definir serviço.

  2. Selecione Serviço personalizado.

    Use o separador **Serviço personalizado** para definir serviços arbitrários.

  3. Introduza um nome a apresentar para o seu serviço personalizado.

  4. Clique em Enviar. Quando o serviço é criado, é apresentada uma notificação de Êxito.

Use a API para criar um serviço personalizado

Para definir um serviço personalizado através da API SLO, publique um objeto de configuração Custom, como o seguinte, no método services.create:

{
  "displayName": "hello-world-service",
  "custom": {}
}

Para mais informações sobre a gestão de serviços por programação, consulte o artigo Trabalhar com a API.

O que se segue?

Depois de identificar ou criar um novo serviço, pode fazer o seguinte:

  • Crie um SLO para o seu novo serviço. Tem de definir, pelo menos, um SLO para o novo serviço para que este seja útil. Para mais informações, consulte o artigo Criar um SLO.
  • Aceda ao painel de controlo do novo serviço. Para um novo serviço, o painel de controlo está vazio, mas pode definir SLOs a partir do painel de controlo. Para mais informações, consulte o artigo Usar painéis de controlo de microsserviços.