Definir un microservicio

En este documento se describe cómo crear servicios personalizados y servicios para algunos recursos, como GKE y Cloud Run.

En Cloud Monitoring, un servicio es una estructura que puede asociar a objetivos de nivel de servicio y políticas de alertas. Algunos de los recursos para los que puedes crear servicios de Monitoring también se denominan servicios, pero con significados diferentes, como los servicios de GKE o los servicios de Cloud Run.

Monitoring puede reconocer los servicios basados en GKE y Cloud Run como candidatos para la monitorización. Para crear servicios para ellos, indica qué candidatos quieres que se traten como servicios de monitorización. Monitoring crea la infraestructura necesaria.

También puedes definir servicios personalizados arbitrarios.

Identificar o crear un servicio

Para identificar los servicios candidatos o crear servicios personalizados, ve al panel Definir servicio:

1. En la Google Cloud consola, ve a la página  SLOs:

   Ve a Objetivos de nivel de servicio.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

2. En la página Resumen de servicios, haz una de las siguientes acciones:

   • Haz clic en add Definir servicio.

   • En el panel Estado actual, haz clic en el enlace Definir servicio:

     

En el panel Definir servicio, puedes hacer lo siguiente:

• Crear servicios a partir de una lista de servicios candidatos.
• Defina servicios personalizados.

En las siguientes secciones se describen estas opciones.

Crear servicios

Cloud Monitoring puede identificar posibles servicios de los siguientes tipos:

• Servicios de Cloud Service Mesh
• Istio en servicios de Google Kubernetes Engine
• Servicios de App Engine
• Espacios de nombres de GKE
• Servicios de GKE
• Cargas de trabajo de GKE
• Servicio de Cloud Run

Como puede haber muchos de estos servicios potenciales, Monitoring no da por hecho que quieras que todos se traten como servicios con SLOs. Para indicar cuáles de los servicios potenciales debe tratar Monitoring como servicios, puede usar laGoogle Cloud consola o la API.

Usa la consola de Google Cloud para crear servicios

Para crear un servicio mediante la consola Google Cloud , sigue estos pasos:

1. En la página Resumen de servicios, haga clic en Definir servicio.

2. Selecciona Candidatos de servicio.

   

   Puede que haya un gran número de servicios candidatos en la lista. Puedes filtrar la lista de la siguiente manera:

   1. Haz clic en filter_list Filtrar tabla. Se muestra una lista de opciones de filtro.

   2. Selecciona una de las opciones de la lista de filtros. La opción seleccionada aparece en la barra de filtros.

   3. Haga clic junto a la opción de la barra de filtros y empiece a escribir. Los valores que coinciden se proporcionan en una lista. Selecciona un valor de la lista.

3. Haga clic en un servicio candidato de la lista de servicios potenciales.

   Cuando haces clic en una entrada, se rellenan los siguientes campos:

   • El nombre visible es el nombre de la entrada de la lista. Puedes cambiar este valor.

   • Se genera un bloque de código JSON para la configuración del nuevo servicio a partir del candidato. No cambies este valor.

4. Haz clic en Enviar. Cuando se cree el servicio, se mostrará un mensaje de Éxito.

Usar la API para crear un servicio

También puedes crear servicios con la API SLO, que forma parte de la API Cloud Monitoring.

Para crear un servicio mediante programación, publica un objeto de configuración como uno de los siguientes en el método services.create:

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

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

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

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

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

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

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

Para obtener más información sobre cómo gestionar servicios mediante programación, consulta los siguientes documentos:

• Estructuras de la API.
• Trabajar con la API.

Crear un servicio personalizado

Si ningún otro tipo de servicio se ajusta a tus necesidades, crea un servicio personalizado. Con un servicio personalizado, puedes agrupar SLOs de forma arbitraria para que se adapten a tu entorno o crear SLOs basados en métricas empresariales que no se correspondan con ningún microservicio.

Usa la Google Cloud consola para crear un servicio personalizado

Para definir un servicio personalizado mediante la consola Google Cloud , haz lo siguiente:

1. En la página Resumen de servicios, haz clic en Definir servicio para que aparezca el panel Definir servicio.

2. Selecciona Servicio personalizado.

   

3. Escriba un nombre visible para su servicio personalizado.

4. Haz clic en Enviar. Cuando se cree el servicio, se mostrará un mensaje de Éxito.

Usar la API para crear un servicio personalizado

Para definir un servicio personalizado mediante la API SLO, publica un objeto de configuración Custom como el siguiente en el método services.create:

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

Para obtener más información sobre cómo gestionar servicios de forma programática, consulta el artículo Trabajar con la API.

Siguientes pasos

Una vez que hayas identificado o creado un nuevo servicio, puedes hacer lo siguiente:

• Crea un SLO para tu nuevo servicio. Para que el servicio sea útil, debes definir al menos un SLO. Para obtener más información, consulta el artículo Crear un SLO.
• Ve al panel de control de tu nuevo servicio. En el caso de un servicio nuevo, el panel de control está vacío, pero puedes definir SLOs desde él. Para obtener más información, consulta Usar paneles de microservicios.