Ver informes de políticas del sistema operativo

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Después de que VM Manager aplica una asignación de política de sistema operativo a una instancia de máquina virtual (VM), se genera un informe de asignación de política de sistema operativo. El informe contiene el estado de cumplimiento de todas las políticas del sistema operativo que se aplican a una máquina virtual específica para una asignación de política del sistema operativo determinada.

Este documento describe las siguientes tareas:

• Vea el informe de cumplimiento de políticas del sistema operativo para todas las máquinas virtuales de una organización o carpeta .
• Vea informes de asignación de políticas del sistema operativo para todas las máquinas virtuales en una zona específica. Esto es útil para proporcionar una descripción general del estado de cumplimiento en una zona específica. Consulte Ver informes de asignación de políticas del sistema operativo .
• Revise la asignación de políticas del sistema operativo para una máquina virtual específica. Esto resulta útil al revisar el estado de cumplimiento de una máquina virtual específica. Consulte Revisar un informe de asignación de políticas del sistema operativo .

Antes de comenzar

• Revise las cuotas de configuración del sistema operativo .
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Roles y permisos necesarios

Para obtener los permisos que necesita para ver los datos de cumplimiento de políticas del sistema operativo, solicite a su administrador que le otorgue las siguientes funciones de IAM:

• Vea el resumen de cumplimiento de políticas del sistema operativo para máquinas virtuales en una organización o carpeta:
  • OSPolicyAssignmentReport Viewer ( roles/osconfig.osPolicyAssignmentReportViewer ) en la organización o carpeta
  • OSPolicyAssignment Viewer ( roles/osconfig.osPolicyAssignmentViewer ) en la organización o carpeta
• Ver informes de asignación de políticas del sistema operativo para máquinas virtuales en un proyecto: OSPolicyAssignmentReport Viewer ( roles/osconfig.osPolicyAssignmentReportViewer ) en el proyecto

Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Estos roles predefinidos contienen los permisos necesarios para ver los datos de cumplimiento de las políticas del sistema operativo. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Ver el resumen de cumplimiento de políticas del sistema operativo para todas las máquinas virtuales en una organización o carpeta

Puede ver el resumen de cumplimiento de la política del sistema operativo para todas las máquinas virtuales de una organización o carpeta mediante la consola de Google Cloud.

VM Manager muestra un resumen de cumplimiento de la política del sistema operativo solo para aquellos proyectos que cumplen uno de los siguientes requisitos:

• Contiene una o más máquinas virtuales en las que VM Manager está habilitado y ejecutándose.
• Contiene una o más máquinas virtuales en las que se ejecutó VM Manager en los últimos 7 días y hay datos de cumplimiento de políticas del sistema operativo disponibles.

Para ver los datos de cumplimiento de la política del sistema operativo, haga lo siguiente:

1. En la consola de Google Cloud, vaya a la página Compute Engine > VM Manager > Políticas del sistema operativo .

   Ir a políticas del sistema operativo

2. En la lista desplegable del proyecto en la parte superior de la consola de Google Cloud, seleccione la organización o carpeta para la que desea ver el resumen de cumplimiento de la política del sistema operativo.

3. Utilice las siguientes opciones para ver los datos de cumplimiento de la política del sistema operativo:

   1. Para ver el resumen de cumplimiento de la política del sistema operativo por proyecto, haga clic en la pestaña Proyectos .
   2. Para ver el resumen de cumplimiento de la política del sistema operativo por política, haga clic en la pestaña Políticas del sistema operativo .

4. Opcional: Especifique los criterios para calcular el resumen de cumplimiento de la política del sistema operativo mediante el generador de consultas .

5. Revise el resumen de cumplimiento de políticas del sistema operativo para máquinas virtuales. La tabla en la pestaña Proyectos incluye una fila para cada proyecto como se muestra en la siguiente figura:

   

   La tabla enumera la siguiente información que cumple con los criterios que ha especificado en el generador de consultas:

   • Proyecto : el nombre de los proyectos de la organización que contienen al menos una VM y tienen habilitado VM Manager.
   • Total de máquinas virtuales : número total de máquinas virtuales en cada proyecto.
   • Máquinas virtuales monitoreadas : cantidad de máquinas virtuales en el proyecto que tienen el agente VM Manager habilitado y que se están analizando para verificar el cumplimiento de la política.
   • Máquinas virtuales con política : número de máquinas virtuales con al menos una política asignada.
   • Cumplido : número de máquinas virtuales con todas sus políticas asignadas informadas como COMPLIANT .
   • No conforme : número de máquinas virtuales con al menos una política asignada informadas como NON-COMPLIANT .
   • Desconocido : número de máquinas virtuales con al menos una política asignada reportada como UNKNOWN y ninguna política reportada como NON-COMPLIANT . El estado UNKNOWN se debe a uno de los siguientes motivos:
     • La máquina virtual no se está ejecutando.
     • El agente de VM Manager no está habilitado para la VM.
     • Se produjo un error durante el proceso.
   • Sin informe : número de máquinas virtuales con políticas asignadas, pero no se encontró ningún informe de cumplimiento de políticas debido a uno de los siguientes motivos:
     • El agente de VM Manager no está habilitado para la VM.
     • El análisis de cumplimiento está en curso. El informe aún no está listo.

6. Opcional: aplique filtros de tabla si desea ver filas específicas en la tabla de resumen de cumplimiento de políticas del sistema operativo.

   

   Por ejemplo, si desea ver un resumen de cumplimiento de políticas del sistema operativo para proyectos que tienen más de 10 máquinas virtuales, configure la opción de filtro Total de máquinas virtuales en >= 10 .

7. Opcional: haga clic en la cantidad de máquinas virtuales para ver más detalles sobre las máquinas virtuales en un estado particular. Por ejemplo, al hacer clic en la cantidad de VM para un proyecto determinado en la columna Desconocido , se abre la pestaña Instancias de VM con una lista de políticas de SO desconocidas para cada VM en ese proyecto.

   

   Para obtener más información, consulte Ver informes de asignación de políticas del sistema operativo .

Utilice el generador de consultas para filtrar los datos de cumplimiento de políticas del sistema operativo

Según los criterios que especificó en el generador de consultas, VM Manager muestra los datos de cumplimiento de la política del sistema operativo para las máquinas virtuales en los proyectos de su organización o carpeta. Luego puede usar los filtros de tabla en la tabla de cumplimiento de políticas del sistema operativo para filtrar los datos mostrados.

Por ejemplo, cuando configura el atributo OS en el generador de consultas como Debian , VM Manager muestra datos de cumplimiento de la política del sistema operativo para las máquinas virtuales con el sistema operativo Debian. Si desea ver los datos de cumplimiento de un proyecto específico, utilice el filtro de tabla para especificar el ID del proyecto.

Para configurar una consulta en el generador de consultas en la pestaña Proyectos , haga lo siguiente:

1. Seleccione un atributo . El generador de consultas admite los siguientes atributos:

   • SO : Especifique los nombres cortos de los sistemas operativos como Windows o Debian .
   • Versión del sistema operativo : especifique la versión del sistema operativo. Por ejemplo, 21.04 o 10.0.22000 . Puede especificar un solo asterisco ( * ) al final de la cadena de versión del sistema operativo para indicar una coincidencia parcial, por ejemplo 10* .
   • Máquina virtual en ejecución : especifique si desea ver el resumen de parches para las máquinas virtuales que están en estado RUNNING .
   • Huella digital de política : especifique la huella digital de política única para la política del sistema operativo. Cuando configura este atributo, VM Manager calcula el resumen de cumplimiento solo para aquellas políticas del sistema operativo con la huella digital especificada.
   • Estado de cumplimiento : especifique uno de los estados de cumplimiento de la política:
     • COMPLIANT : máquinas virtuales con todas las políticas asignadas informadas como COMPLIANT
     • NON-COMPLIANT : las máquinas virtuales con al menos una política asignada se informan como NON-COMPLIANT
     • UNKNOWN : VM con al menos una política asignada reportadas como UNKNOWN

2. Elija uno de los atributos y especifique un valor para el atributo. Por ejemplo, si desea ver un resumen de parches para máquinas virtuales con un sistema operativo específico, seleccione SO . Luego obtendrá una lista de operadores de comparación para elegir.

   1. Seleccione un Operador , por ejemplo, == .
   2. En el campo Valor , especifique el valor de comparación. Por ejemplo Debian .

3. Para agregar otro atributo, haga clic en Agregar condición .

4. Haga clic en Buscar .

Ver informes de asignación de políticas del sistema operativo

Para ver los informes de asignación de políticas del sistema operativo, puede usar la consola de Google Cloud, la CLI de Google Cloud o REST .

Utilice este procedimiento para ver una lista de informes de asignación de políticas del sistema operativo para una ubicación específica.

gcloud compute os-config os-policy-assignment-reports list --location=ZONE

gcloud compute os-config os-policy-assignment-reports list --location=us-central1-a

INSTANCE                   ASSIGNMENT_ID                   LOCATION       UPDATE_TIME                  SUMMARY
centos7                    my-test-assignment1             us-central1-a  2021-11-02T18:14:03.908341Z  0/1 policies compliant
centos7                    my-test-assignment2             us-central1-a  2021-11-02T18:14:03.908341Z  0/1 policies compliant
rhel-8                     my-test-assignment1             us-central1-a  2021-11-02T19:13:28.468290Z  0/1 policies compliant
rhel-8                     my-test-assignment2             us-central1-a  2021-11-02T19:13:28.468290Z  0/1 policies compliant
my-centos                  my-test-assignment1             us-central1-a  2021-11-02T18:14:37.418883Z  1/1 policies compliant
my-centos                  my-test-assignment2             us-central1-a  2021-11-02T18:14:37.418883Z  0/1 policies compliant
deb-10                     my-test-assignment2             us-central1-a  2021-11-02T19:00:11.777748Z  0/1 policies compliant
windows                    my-test-assignment2             us-central1-a  2021-11-02T18:24:07.935711Z  0/1 policies compliant
windows                    my-test-assignment3             us-central1-a  2021-11-02T18:24:07.935711Z  0/1 policies compliant
sles15                     my-test-assignment2             us-central1-a  2021-11-02T18:38:07.335276Z  0/1 policies compliant

gcloud compute os-config os-policy-assignment-reports list --location=ZONE \
    [--instance=VM_NAME | --assignment-id=ASSIGNMENT_ID]

gcloud compute os-config os-policy-assignment-reports list --location=us-central1-a \
    --instance=my-centos

INSTANCE                ASSIGNMENT_ID               LOCATION       UPDATE_TIME                  SUMMARY
my-centos               my-test-assignment1         us-central1-a  2021-11-02T18:14:37.418883Z  1/1 policies compliant
my-centos               my-test-assignment2         us-central1-a  2021-11-02T18:14:37.418883Z  0/1 policies compliant

gcloud compute os-config os-policy-assignment-reports list --location=us-central1-a \
    --assignment-id=my-test-assignment1

INSTANCE                ASSIGNMENT_ID               LOCATION       UPDATE_TIME                  SUMMARY
centos7                 my-test-assignment1         us-central1-a  2021-11-02T18:14:03.908341Z  0/1 policies compliant
rhel-8                  my-test-assignment1         us-central1-a  2021-11-02T19:13:28.468290Z  0/1 policies compliant
my-centos               my-test-assignment1         us-central1-a  2021-11-02T18:14:37.418883Z  1/1 policies compliant

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/VM_NAME/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID/report

Revisar un informe de asignación de políticas del sistema operativo

Utilice este procedimiento para obtener una vista detallada de un informe de asignación de políticas del sistema operativo asociado con una máquina virtual específica.

¿Qué sigue?

• Obtenga más información sobre las políticas del sistema operativo .
• Administrar políticas del sistema operativo .