Configura los registros de flujo de VPC
En esta página, se explica cómo configurar los registros de flujo de VPC. Se supone que conoces los conceptos descritos en Registros de flujo de VPC y Acerca de los registros de flujo de VPC.
Antes de comenzar
Configura al menos una de las siguientes opciones:
La API de Network Management te permite configurar registros de flujo de VPC para organizaciones, redes de nube privada virtual (VPC), subredes, adjuntos de VLAN para Cloud Interconnect y túneles de Cloud VPN. Para usar la API de Network Management, haz lo siguiente:
Habilita la API de Network Management en tu Google Cloud proyecto.
Asegúrate de tener el rol de Administrador de Network Management (
roles/networkmanagement.admin
), otorgado de la siguiente manera:- A nivel de la organización (obligatorio si deseas configurar los registros de flujo de VPC para una organización)
- A nivel del proyecto (obligatorio si deseas configurar registros de flujo de VPC para una red de VPC, una subred, un adjunto de VLAN o un túnel de Cloud VPN)
Además, si deseas configurar los registros de flujo de VPC para una organización, asegúrate de tener el permiso
resourcemanager.organizations.get
.
La API de Compute Engine te permite configurar los registros de flujo de VPC para las subredes. Los parámetros de configuración creados con la API de Compute Engine no se pueden administrar con la API de Network Management. Para usar la API de Compute Engine, haz lo siguiente:
Habilita la API de Compute Engine en tu Google Cloud proyecto.
Asegúrate de tener uno de los siguientes roles en el proyecto:
- Rol de administrador de Compute (
roles/compute.admin
) - Rol Compute Network Admin (
roles/compute.networkAdmin
)
- Rol de administrador de Compute (
Configura la CLI de Google Cloud
Omite este paso si no tienes previsto usar gcloud CLI para configurar los registros de flujo de VPC.
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Habilitar los registros de flujo de VPC
Para habilitar los registros de flujo de VPC en un recurso, crea una configuración de registros de flujo de VPC. Los registros de flujo de VPC te permiten crear configuraciones a nivel de la organización y del proyecto:
- Una configuración a nivel de la organización habilita los registros de flujo para todas las subredes, los adjuntos de VLAN y los túneles de Cloud VPN en todas las redes de VPC de la organización. Estas configuraciones habilitan anotaciones entre proyectos de forma predeterminada.
- Una configuración a nivel del proyecto te permite habilitar registros de flujo para los siguientes recursos:
- Una red de VPC específica, que incluye todas las subredes, los adjuntos de VLAN y los túneles de Cloud VPN en la red
- Una subred, un adjunto de VLAN o un túnel de Cloud VPN específicos
Puedes agregar más de una configuración de registros de flujo de VPC por recurso. Cada configuración genera un conjunto independiente de registros de flujo. Si asocias un recurso con varias configuraciones de registros de flujo de VPC y su alcance se superpone, es posible que la información de registro contenga registros duplicados. Para obtener más información, consulta Configuraciones compatibles.
También puedes modificar la cantidad de información escrita en el registro. Para obtener más información sobre los parámetros que puedes controlar, consulta Muestreo y procesamiento de registros.
Habilita los registros de flujo de VPC en una subred
Cuando habilitas los registros de flujo de VPC para una subred, se habilita el registro para todas las VMs de la subred.
Habilita los registros de flujo de VPC en una subred (API de Network Management)
En esta sección, se describe cómo habilitar los registros de flujo de VPC para una subred con la API de Network Management.
Console
En la consola de Google Cloud , ve a la página Redes de VPC.
En la pestaña Subredes del proyecto actual, selecciona una o más subredes y, luego, haz clic en
Administrar registros de flujo.En
Administrar registros de flujo, haz clic en Agregar nueva configuración.En la sección Configuraciones: Subredes (versión preliminar), haz clic en Agregar una configuración.
En Nombre, ingresa un nombre para la nueva configuración de los registros de flujo de VPC.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los parámetros de configuración de la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Para habilitar los registros de flujo de VPC en una subred, usa el comando gcloud beta network-management vpc-flow-logs-configs create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
En gcloud CLI, establece tu proyecto en el Google Cloud ID del proyecto de la subred y ejecuta uno de los siguientes comandos:
Para crear una configuración predeterminada de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --subnet=SUBNET
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --subnet=SUBNET \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA
Reemplaza lo siguiente:
CONFIG_NAME
: Es un nombre para la configuración.SUBNET
: Es la subred que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/regions/REGION/subnetworks/NAME
, en el que:PROJECT_ID
es el ID del proyecto Google Cloud que contiene la subred. La configuración se debe crear en este proyecto.REGION
es la región de la subred.NAME
es el nombre de la subred.
Para establecer los parámetros opcionales en una configuración personalizada, reemplaza lo siguiente:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
API
Para habilitar los registros de flujo de VPC en una subred, usa el método projects.locations.vpcFlowLogsConfigs.create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
Para crear una configuración predeterminada de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "subnet": "SUBNET" }
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "subnet": "SUBNET", "aggregationInterval": "AGGREGATION_INTERVAL", "filterExpr": "FILTER_EXPRESSION", "flowSampling": SAMPLING_RATE, "metadata": "LOGGING_METADATA" }
Reemplaza lo siguiente:
PROJECT_ID
: El Google Cloud ID del proyecto de la subred.CONFIG_NAME
: Es un nombre para la configuración.SUBNET
: Es la subred que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/regions/REGION/subnetworks/NAME
, en el que:PROJECT_ID
es el ID del proyecto de la subred.REGION
es la región de la subred.NAME
es el nombre de la subred.
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer enINTERVAL_5_SEC
(predeterminada),INTERVAL_30_SEC
,INTERVAL_1_MIN
,INTERVAL_5_MIN
,INTERVAL_10_MIN
oINTERVAL_15_MIN
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros::- Usa
INCLUDE_ALL_METADATA
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
EXCLUDE_ALL_METADATA
para excluir todas las anotaciones de metadatos. - Usa
CUSTOM_METADATA
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa el parámetrometadataFields
:metadataFields: METADATA_FIELDS
: ReemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo:src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comoCUSTOM_METADATA
.
- Usa
Habilita los registros de flujo de VPC en una subred (API de Compute Engine)
En esta sección, se describe cómo habilitar los registros de flujo de VPC para una subred con la API de Compute Engine. Puedes habilitar los registros de flujo de VPC cuando creas una subred o para una subred existente.
Habilita los registros de flujo de VPC cuando crees una subred
Console
En la consola de Google Cloud , ve a la página Redes de VPC.
Haz clic en la red en la que quieres agregar una subred.
Haz clic en Agregar subred.
En Registros de flujo, selecciona Activado.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los siguientes parámetros de configuración en la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
50%
significa que se conserva la mitad de las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Propaga los demás campos como corresponda.
Haz clic en Agregar.
gcloud
Ejecuta el siguiente comando:
gcloud compute networks subnets create SUBNET_NAME \ --enable-flow-logs \ [--logging-aggregation-interval=AGGREGATION_INTERVAL] \ [--logging-flow-sampling=SAMPLING_RATE] \ [--logging-filter-expr=FILTER_EXPRESSION] \ [--logging-metadata=LOGGING_METADATA] \ [--logging-metadata-fields=METADATA_FIELDS] \ [other flags as needed]
Reemplaza lo siguiente:
AGGREGATION_INTERVAL
: el intervalo de agregación para los registros de flujo en esa subred. El intervalo se puede establecer en cualquiera de las siguientes opciones: 5 s (predeterminado), 30 s, 1 min, 5 min, 10 min o 15 min.SAMPLING_RATE
: La tasa de muestreo de flujo secundario. El muestreo de flujo secundario se puede establecer desde0.0
(sin muestreo) hasta1.0
(todos los registros). El valor predeterminado es0.5
. Para obtener más información, consulta Muestreo y procesamiento de registros.FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más detalles, consulta Filtrado de registros.LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all
para incluir todas las anotaciones de metadatos. - Usa
exclude-all
para excluir todas las anotaciones de metadatos (predeterminado). - Usa
custom
para incluir una lista personalizada de los campos de metadatos que especifiques enMETADATA_FIELDS
.
- Usa
METADATA_FIELDS
: una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
Solo se puede configurar siLOGGING_METADATA
se establece comocustom
.
API
Habilita los registros de flujo de VPC cuando crees una nueva subred.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks { "logConfig": { "aggregationInterval": "AGGREGATION_INTERVAL", "flowSampling": SAMPLING_RATE, "filterExpr": EXPRESSION, "metadata": METADATA_SETTING, "metadataFields": METADATA_FIELDS, "enable": true }, "ipCidrRange": "IP_RANGE", "network": "NETWORK_URL", "name": "SUBNET_NAME" }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto en el que se creará la subred.REGION
: La región en la que se creará la subred.AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo en la subred. El intervalo se puede establecer en cualquiera de las siguientes opciones:INTERVAL_5_SEC
,INTERVAL_30_SEC
,INTERVAL_1_MIN
,INTERVAL_5_MIN
,INTERVAL_10_MIN
oINTERVAL_15_MIN
.SAMPLING_RATE
: La tasa de muestreo de flujo. El muestreo de flujo se puede establecer desde0.0
(sin muestreo) hasta1.0
(todos los registros). El valor predeterminado es.0.5
.EXPRESSION
: La expresión de filtro que usas para filtrar qué registros se escriben. La expresión tiene un límite de 2,048 caracteres. Para obtener más detalles, consulta Filtrado de registros.METADATA_SETTING
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
INCLUDE_ALL_METADATA
para incluir todas las anotaciones de metadatos. - Usa
EXCLUDE_ALL_METADATA
para excluir todas las anotaciones de metadatos (predeterminado). - Usa
CUSTOM_METADATA
para incluir una lista personalizada de los campos de metadatos que especifiques enMETADATA_FIELDS
.
- Usa
METADATA_FIELDS
: Los campos de metadatos que deseas capturar cuando configurasmetadata: CUSTOM_METADATA
. Esta es una lista de campos de metadatos separados por comas, comosrc_instance, src_vpc.project_id
.IP_RANGE
: El rango de direcciones IP internas principal de la subred.NETWORK_URL
: La URL de la red de nube privada virtual en la que se creará la subred.SUBNET_NAME
: Es un nombre de la subred.
Para obtener más información, consulta el método subnetworks.insert
.
Terraform
Puedes usar un módulo de Terraform para crear una subred y una red de VPC en modo personalizado.
En el siguiente ejemplo, se crean tres subredes de la siguiente manera:
subnet-01
tiene inhabilitados los registros de flujo de VPC. Cuando creas una subred, los registros de flujo de VPC se inhabilitan, a menos que los habilites de manera explícita.subnet-02
tiene habilitados los registros de flujo de VPC con la configuración de registro de flujo predeterminada.subnet-03
tiene habilitados los registros de flujo de VPC con algunos parámetros de configuración personalizados.
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
Habilita los registros de flujo de VPC en una subred existente
Console
En la consola de Google Cloud , ve a la página Redes de VPC.
Haz clic en la subred que quieres actualizar.
Haz clic en Editar.
En Registros de flujo, selecciona Activado.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los siguientes parámetros de configuración en la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
50%
significa que se conserva la mitad de las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Ejecuta el siguiente comando:
gcloud compute networks subnets update SUBNET_NAME \ --enable-flow-logs \ [--logging-aggregation-interval=AGGREGATION_INTERVAL] \ [--logging-flow-sampling=SAMPLING_RATE] \ [--logging-filter-expr=FILTER_EXPRESSION] \ [--logging-metadata=LOGGING_METADATA] \ [--logging-metadata-fields=METADATA_FIELDS] \ [other flags as needed]
Reemplaza lo siguiente:
AGGREGATION_INTERVAL
: el intervalo de agregación para los registros de flujo en esa subred. El intervalo se puede establecer en cualquiera de las siguientes opciones: 5 s (predeterminado), 30 s, 1 min, 5 min, 10 min o 15 min.SAMPLING_RATE
: La tasa de muestreo de flujo secundario. El muestreo de flujo secundario se puede establecer desde0.0
(sin muestreo) hasta1.0
(todos los registros). El valor predeterminado es0.5
. Para obtener más información, consulta Muestreo y procesamiento de registros.FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más detalles, consulta Filtrado de registros.LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all
para incluir todas las anotaciones de metadatos. - Usa
exclude-all
para excluir todas las anotaciones de metadatos (predeterminado). - Usa
custom
para incluir una lista personalizada de los campos de metadatos que especifiques enMETADATA_FIELDS
.
- Usa
METADATA_FIELDS
: una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
Solo se puede configurar siLOGGING_METADATA
se establece comocustom
.
API
Habilita los registros de flujo de VPC en una subred existente.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME { "logConfig": { "enable": true ...other logging fields. }, "fingerprint": "SUBNET_FINGERPRINT" }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto en el que está la subred.REGION
: La región en la que se encuentra la subred.SUBNET_NAME
: el nombre de la subred existente.SUBNET_FINGERPRINT
: Es el ID de huella digital de la subred existente, que se proporciona cuando describes una subred.- Para los otros campos de registro, consulta la sección sobre cómo habilitar el registro de flujo de VPC cuando creas una subred.
Para obtener más información, consulta el método subnetworks.patch
.
Habilita los registros de flujo de VPC para un adjunto de VLAN
Console
En la consola de Google Cloud , ve a la página Interconnect.
En la pestaña Adjuntos de VLAN, selecciona uno o más adjuntos de VLAN y, luego, haz clic en
Administrar registros de flujo en la barra de selección que se encuentra en la parte superior de la lista.En
Administrar registros de flujo, haz clic en Agregar nueva configuración.En Nombre, ingresa un nombre para la nueva configuración de los registros de flujo de VPC.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los parámetros de configuración de la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Para habilitar los registros de flujo de VPC para un adjunto de VLAN, usa el comando gcloud network-management vpc-flow-logs-configs create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
En gcloud CLI, establece tu proyecto en el ID del proyectoGoogle Cloud del adjunto de VLAN y ejecuta uno de los siguientes comandos:
Para crear una configuración predeterminada de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --interconnect-attachment=VLAN_ATTACHMENT
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --interconnect-attachment=VLAN_ATTACHMENT \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA
Reemplaza lo siguiente:
CONFIG_NAME
: Es un nombre para la configuración.VLAN_ATTACHMENT
: Es el adjunto de VLAN que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME
, en el que:PROJECT_ID
es el ID del proyecto Google Cloud que contiene el adjunto de VLAN. La configuración se debe crear en este proyecto.REGION
es la región del adjunto de VLAN.NAME
es el nombre del adjunto de VLAN.
Para establecer los parámetros opcionales en una configuración personalizada, reemplaza lo siguiente:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
Terraform
Puedes usar un módulo de Terraform para crear una configuración de registros de flujo de VPC para un adjunto de VLAN.
Con el siguiente bloque de código, se crea una configuración predeterminada de los registros de flujo de VPC.
En el ejemplo anterior, se supone que el nombre del recurso google_compute_interconnect_attachment
es attachment
. Para ver un ejemplo completo de esta configuración, consulta el repositorio terraform-docs-samples.
El siguiente bloque de código crea una configuración de registros de flujo de VPC en la que se hace lo siguiente:
- El intervalo de agregación se establece en
INTERVAL_10_MIN
. - La tasa de muestreo de flujo secundario se establece en
0.7
. - Los metadatos que se incluirán en los registros se establecen en
INCLUDE_ALL_METADATA
. - El estado de configuración se establece en
ENABLED
.
En el ejemplo anterior, se supone que el nombre del recurso google_compute_interconnect_attachment
es attachment
. Para ver un ejemplo completo de esta configuración, consulta el repositorio terraform-docs-samples.
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
API
Para habilitar los registros de flujo de VPC para un adjunto de VLAN, usa el método projects.locations.vpcFlowLogsConfigs.create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
Para crear una configuración predeterminada de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "interconnectAttachment": "VLAN_ATTACHMENT" }
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "interconnectAttachment": "VLAN_ATTACHMENT", "aggregationInterval": "AGGREGATION_INTERVAL", "filterExpr": "FILTER_EXPRESSION", "flowSampling": SAMPLING_RATE, "metadata": "LOGGING_METADATA" }
Reemplaza lo siguiente:
PROJECT_ID
: Es el Google Cloud ID del proyecto del adjunto de VLAN.CONFIG_NAME
: Es un nombre para la configuración.VLAN_ATTACHMENT
: Es el adjunto de VLAN que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME
, en el que:PROJECT_ID
es el ID del proyecto del adjunto de VLAN.REGION
es la región del adjunto de VLAN.NAME
es el nombre del adjunto de VLAN.
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer enINTERVAL_5_SEC
(predeterminada),INTERVAL_30_SEC
,INTERVAL_1_MIN
,INTERVAL_5_MIN
,INTERVAL_10_MIN
oINTERVAL_15_MIN
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros::- Usa
INCLUDE_ALL_METADATA
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
EXCLUDE_ALL_METADATA
para excluir todas las anotaciones de metadatos. - Usa
CUSTOM_METADATA
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa el parámetrometadataFields
:metadataFields: METADATA_FIELDS
: ReemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo:src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comoCUSTOM_METADATA
.
- Usa
Habilita los registros de flujo de VPC en un túnel de Cloud VPN
Console
En la consola de Google Cloud , ve a la página VPN.
En la pestaña Túneles de Cloud VPN, selecciona uno o más túneles de Cloud VPN y, luego, haz clic en
Administrar registros de flujo en la barra de selección que se encuentra en la parte superior de la lista.En
Administrar registros de flujo, haz clic en Agregar nueva configuración.En Nombre, ingresa un nombre para la nueva configuración de los registros de flujo de VPC.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los parámetros de configuración de la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Para habilitar los registros de flujo de VPC en un túnel de Cloud VPN, usa el
comando gcloud network-management vpc-flow-logs-configs create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
En gcloud CLI, establece tu proyecto en el ID del proyectoGoogle Cloud del túnel de Cloud VPN y ejecuta uno de los siguientes comandos:
Para crear una configuración predeterminada de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --vpn-tunnel=VPN_TUNNEL
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --vpn-tunnel=VPN_TUNNEL \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA
Reemplaza lo siguiente:
CONFIG_NAME
: Es un nombre para la configuración.VPN_TUNNEL
: Es el túnel de Cloud VPN que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME
, en el que:PROJECT_ID
es el ID del proyecto Google Cloud que contiene el túnel de la Cloud VPN. La configuración se debe crear en este proyecto.REGION
es la región del túnel de Cloud VPN.NAME
es el nombre del túnel de Cloud VPN.
Para establecer los parámetros opcionales en una configuración personalizada, reemplaza lo siguiente:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
Terraform
Puedes usar un módulo de Terraform para crear una configuración de registros de flujo de VPC para un túnel de Cloud VPN.
Con el siguiente bloque de código, se crea una configuración predeterminada de los registros de flujo de VPC.
En el ejemplo anterior, se supone que el nombre del recurso google_compute_vpn_tunnel
es tunnel
. Para ver un ejemplo completo de esta configuración, consulta el repositorio terraform-docs-samples.
El siguiente bloque de código crea una configuración de registros de flujo de VPC en la que se hace lo siguiente:
- El intervalo de agregación se establece en
INTERVAL_10_MIN
. - La tasa de muestreo de flujo secundario se establece en
0.7
. - Los metadatos que se incluirán en los registros se establecen en
INCLUDE_ALL_METADATA
. - El estado de configuración se establece en
ENABLED
.
En el ejemplo anterior, se supone que el nombre del recurso google_compute_vpn_tunnel
es tunnel
. Para ver un ejemplo completo de esta configuración, consulta el repositorio terraform-docs-samples.
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
API
Para habilitar los registros de flujo de VPC en un túnel de Cloud VPN, usa el método projects.locations.vpcFlowLogsConfigs.create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
Para crear una configuración predeterminada de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "vpnTunnel": "VPN_TUNNEL" }
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "vpnTunnel": "VPN_TUNNEL", "aggregationInterval": "AGGREGATION_INTERVAL", "filterExpr": "FILTER_EXPRESSION", "flowSampling": SAMPLING_RATE, "metadata": "LOGGING_METADATA" }
Reemplaza lo siguiente:
-
PROJECT_ID
: El Google Cloud ID del proyecto del túnel de Cloud VPN. -
CONFIG_NAME
: Es un nombre para la configuración. -
VPN_TUNNEL
: Es el túnel de Cloud VPN que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME
, en el que:PROJECT_ID
es el ID del proyecto del túnel de Cloud VPN.REGION
es la región del túnel de Cloud VPN.NAME
es el nombre del túnel de Cloud VPN.
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer enINTERVAL_5_SEC
(predeterminada),INTERVAL_30_SEC
,INTERVAL_1_MIN
,INTERVAL_5_MIN
,INTERVAL_10_MIN
oINTERVAL_15_MIN
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros::- Usa
INCLUDE_ALL_METADATA
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
EXCLUDE_ALL_METADATA
para excluir todas las anotaciones de metadatos. - Usa
CUSTOM_METADATA
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa el parámetrometadataFields
:metadataFields: METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo:src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comoCUSTOM_METADATA
.
- Usa
Habilita los registros de flujo de VPC para una red de VPC
Para habilitar los registros de flujo de VPC en todas las subredes, los adjuntos de VLAN y los túneles de Cloud VPN en una red de VPC, haz lo siguiente.
Console
En la consola de Google Cloud , ve a la página Redes de VPC.
En la pestaña Redes en el proyecto actual, selecciona una o más redes y, luego, haz clic en
Administrar registros de flujo en la parte superior de la lista.En
Administrar registros de flujo, haz clic en Agregar nueva configuración.En Nombre, ingresa un nombre para la nueva configuración de los registros de flujo de VPC.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los parámetros de configuración de la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Para habilitar los registros de flujo de VPC para una red de VPC, usa el comando gcloud beta network-management vpc-flow-logs-configs create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
En gcloud CLI, establece tu proyecto en el ID de proyectoGoogle Cloud de la red de VPC y ejecuta uno de los siguientes comandos:
Para crear una configuración predeterminada de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --network=NETWORK
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --network=NETWORK \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA
Reemplaza lo siguiente:
CONFIG_NAME
: Es un nombre para la configuración.NETWORK
: Es la red de VPC que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/global/networks/NAME
, en el que:PROJECT_ID
es el ID del proyecto Google Cloud que contiene la red de VPC. La configuración se debe crear en este proyecto.NAME
es el nombre de la red de VPC.
Para establecer los parámetros opcionales en una configuración personalizada, reemplaza lo siguiente:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
API
Para habilitar los registros de flujo de VPC para una red de VPC, usa el método projects.locations.vpcFlowLogsConfigs.create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
Para crear una configuración predeterminada de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "network": "NETWORK" }
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "network": "NETWORK", "aggregationInterval": "AGGREGATION_INTERVAL", "filterExpr": "FILTER_EXPRESSION", "flowSampling": SAMPLING_RATE, "metadata": "LOGGING_METADATA" }
Reemplaza lo siguiente:
PROJECT_ID
: Es el Google Cloud ID del proyecto de la red de VPC.CONFIG_NAME
: Es un nombre para la configuración.NETWORK
: Es la red de VPC que deseas registrar. Se debe especificar en el siguiente formato:projects/PROJECT_ID/global/networks/NAME
, en el que:PROJECT_ID
es el ID del proyecto de la red de VPC.NAME
es el nombre de la red de VPC.
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer enINTERVAL_5_SEC
(predeterminada),INTERVAL_30_SEC
,INTERVAL_1_MIN
,INTERVAL_5_MIN
,INTERVAL_10_MIN
oINTERVAL_15_MIN
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros::- Usa
INCLUDE_ALL_METADATA
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
EXCLUDE_ALL_METADATA
para excluir todas las anotaciones de metadatos. - Usa
CUSTOM_METADATA
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa el parámetrometadataFields
:metadataFields: METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo:src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comoCUSTOM_METADATA
.
- Usa
Habilita los registros de flujo de VPC para una organización
Para habilitar los registros de flujo de VPC en todas las subredes, los adjuntos de VLAN y los túneles de Cloud VPN en todas las redes de VPC de una organización, haz lo siguiente.
Console
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
Haz clic en Agregar configuración de registros de flujo de VPC y, luego, en Agregar una configuración para la organización.
En Nombre, ingresa un nombre para la nueva configuración de los registros de flujo de VPC.
Opcional: Ajusta el Intervalo de agregación y cualquiera de los parámetros de configuración de la sección Configuración avanzada:
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Si se incluyen anotaciones entre proyectos. De forma predeterminada, está seleccionada la opción Anotaciones de metadatos entre proyectos. Para obtener más información, consulta Anotaciones entre proyectos.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Para habilitar los registros de flujo de VPC para una organización, usa el comando gcloud beta network-management vpc-flow-logs-configs create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
Para crear una configuración predeterminada de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --organization=ORGANIZATION
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --organization=ORGANIZATION \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA \ --cross-project-metadata=CROSS_PROJECT_METADATA
Reemplaza lo siguiente:
CONFIG_NAME
: Es un nombre para la configuración.ORGANIZATION
: El ID de la organización
Para establecer los parámetros opcionales en una configuración personalizada, reemplaza lo siguiente:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
CROSS_PROJECT_METADATA
: Anotaciones entre proyectos. Se puede establecer encross-project-metadata-enabled
(predeterminado) ocross-project-metadata-disabled
. Para obtener más información, consulta Anotaciones entre proyectos.
API
Para habilitar los registros de flujo de VPC para una organización, usa el método organizations.locations.vpcFlowLogsConfigs.create
.
Para habilitar los registros de flujo de VPC, crea una configuración de registros de flujo de VPC. Puedes crear la configuración con todos sus parámetros establecidos en sus valores predeterminados, o bien puedes personalizarlos.
Para crear una configuración predeterminada de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
Para crear una configuración personalizada de los registros de flujo de VPC, especifica cada parámetro que desees personalizar.
Por ejemplo, para personalizar el intervalo de agregación, el filtrado, la tasa de muestreo secundaria y los parámetros de metadatos cuando crees una configuración de registros de flujo de VPC, incluye los siguientes parámetros en tu solicitud a la API:
POST -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME { "aggregationInterval": "AGGREGATION_INTERVAL", "filterExpr": "FILTER_EXPRESSION", "flowSampling": SAMPLING_RATE, "metadata": "LOGGING_METADATA", "crossProjectMetadata": "CROSS_PROJECT_METADATA" }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de cuota. Las solicitudes a la API se registran en este proyecto. El valor de la cuota de la API de Network Management se establece en 1,200 solicitudes por minuto para la cuota a nivel del proyecto y de la organización.-
ORGANIZATION_ID
: El ID de la organización. CONFIG_NAME
: Es un nombre para la configuración.
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer enINTERVAL_5_SEC
(predeterminada),INTERVAL_30_SEC
,INTERVAL_1_MIN
,INTERVAL_5_MIN
,INTERVAL_10_MIN
oINTERVAL_15_MIN
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros::- Usa
INCLUDE_ALL_METADATA
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
EXCLUDE_ALL_METADATA
para excluir todas las anotaciones de metadatos. - Usa
CUSTOM_METADATA
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa el parámetrometadataFields
:metadataFields: METADATA_FIELDS
: ReemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo:src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comoCUSTOM_METADATA
.
- Usa
CROSS_PROJECT_METADATA
: Anotaciones entre proyectos Se puede establecer enCROSS_PROJECT_METADATA_ENABLED
(predeterminado) oCROSS_PROJECT_METADATA_DISABLED
. Para obtener más información, consulta Anotaciones entre proyectos.
Cuando los registros de flujo de VPC están habilitados para una organización, los registros de flujo se escriben y se facturan al proyecto Google Cloud del recurso que informa los registros de flujo. Para obtener más información, consulta Precios y facturación.
Consulta el estado de configuración de los registros de flujo de VPC
Para verificar qué recursos tienen habilitados los registros de flujo de VPC, puedes ver sus configuraciones.
Visualiza las configuraciones de los registros de flujo de VPC
Console
Para ver todas las configuraciones de los registros de flujo de VPC, haz lo siguiente:
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
En las secciones Configuraciones a nivel de la organización y Configuraciones a nivel del proyecto, consulta las configuraciones activas y pausadas. Si el estado de la configuración de los registros de flujo de VPC para un recurso es Activado, significa que el registro está activado.
También puedes ver las configuraciones de los registros de flujo de VPC en la columna Configuraciones de registros de flujo de la página del recurso. Por ejemplo, para ver qué redes y subredes de VPC tienen configuraciones de registros de flujo de VPC, haz lo siguiente:
Ir a la página de redes de VPC
Haz clic en la pestaña Redes en el proyecto actual o Subredes en el proyecto actual y, en la columna Configuraciones de registro de flujo, consulta las configuraciones de registros de flujo de VPC activas y pausadas.
gcloud
Para ver las configuraciones de los registros de flujo de VPC, usa los comandos
gcloud network-management vpc-flow-logs-configs list
y
gcloud network-management vpc-flow-logs-configs describe
.
Ver parámetros de configuración a nivel de la organización (versión preliminar)
Para ver todas las configuraciones de los registros de flujo de VPC de una organización, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs list --location=global \ --organization=ORGANIZATION
Para ver una configuración específica de los registros de flujo de VPC, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs describe CONFIG_NAME \ --location=global \ --organization=ORGANIZATION
Reemplaza lo siguiente:
ORGANIZATION
: El ID de la organizaciónCONFIG_NAME
: Es el nombre de la configuración.
Cómo ver los parámetros de configuración a nivel del proyecto
Para ver todas las configuraciones de los registros de flujo de VPC en un proyecto, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs list --location=global
Para ver una configuración específica de los registros de flujo de VPC, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs describe CONFIG_NAME \ --location=global
Reemplaza
CONFIG_NAME
por el nombre de la configuración de los registros de flujo de VPC que deseas ver.Para ver las configuraciones de los registros de flujo de VPC para redes y subredes de VPC, usa la versión beta de estos comandos.
API
Ver parámetros de configuración a nivel de la organización (versión preliminar)
Para ver todas las configuraciones de los registros de flujo de VPC para una organización, usa el método
organizations.locations.vpcFlowLogsConfigs.list
:GET -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs
Para ver una configuración específica de registros de flujo de VPC para una organización, usa el método
organizations.locations.vpcFlowLogsConfigs.get
:GET -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de cuota. Las solicitudes a la API se registran en este proyecto.ORGANIZATION_ID
: El ID de la organización.CONFIG_NAME
: Es el nombre de la configuración.
Si no tienes los permisos necesarios para realizar las tareas anteriores a nivel de la organización, puedes usar la siguiente solicitud para ver todas las configuraciones de los registros de flujo de VPC de la organización:
GET https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs:queryOrgVpcFlowLogsConfigs
Reemplaza
PROJECT_ID
por el ID del proyecto.
Cómo ver los parámetros de configuración a nivel del proyecto
Para ver todas las configuraciones de los registros de flujo de VPC en un proyecto, usa el método
projects.locations.vpcFlowLogsConfigs.list
:GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs
Para ver una configuración específica de registros de flujo de VPC, usa el método
projects.locations.vpcFlowLogsConfigs.get
:GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyectoCONFIG_NAME
: Es el nombre de la configuración de los registros de flujo de VPC.
Para ver las configuraciones de los registros de flujo de VPC para redes y subredes de VPC, usa la versión v1beta1 de estas solicitudes.
Visualiza qué subredes en una red tienen habilitados los registros de flujo de VPC
En esta sección, se describe cómo ver qué parámetros de configuración de los registros de flujo de VPC de las subredes administra la API de Compute Engine. Para ver todas las configuraciones de los registros de flujo de VPC, consulta Cómo ver la configuración de los registros de flujo de VPC.
Console
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
En la sección Configuraciones a nivel del proyecto, haz clic en la pestaña Subredes (API de Compute Engine) y consulta qué subredes del proyecto tienen habilitados los registros de flujo de VPC.
La API de Compute Engine administra estos parámetros de configuración. Las configuraciones que administra la API de Network Management se muestran en la pestaña Subnets.
gcloud
Para ver qué subredes en una red de VPC tienen habilitados los registros de flujo de VPC, ejecuta el siguiente comando:
gcloud compute networks subnets list \ --project PROJECT_ID \ --network="NETWORK" \ --format="csv(name,region,logConfig.enable)"
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto que consultas.NETWORK
: Es el nombre de la red que contiene las subredes.
Actualiza la configuración de los registros de flujo de VPC
Puedes actualizar una configuración de registros de flujo de VPC. Para obtener más información sobre los parámetros que puedes modificar, consulta Muestreo y procesamiento de registros.
Cómo actualizar una configuración a nivel de la organización
Si actualizas la configuración de los registros de flujo de VPC de una organización (versión preliminar), se aplicará la configuración modificada a todas las subredes, los adjuntos de VLAN y los túneles de Cloud VPN de todas las redes de VPC de la organización.
Console
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
En la sección Parámetros de configuración a nivel de la organización, selecciona uno o más parámetros de configuración que quieras actualizar y haz clic en Editar.
Ajusta cualquiera de las siguientes opciones:
- El Intervalo de agregación De forma predeterminada, el intervalo de agregación se establece en 5 s.
- Indica si se debe establecer el Estado de la configuración de los registros de flujo de VPC como activado o desactivado. El estado Activado significa que la configuración de los registros de flujo de VPC seleccionada está activa y genera registros de flujo.
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Si se incluyen anotaciones entre proyectos. De forma predeterminada, está seleccionada la opción Anotaciones de metadatos entre proyectos. Para obtener más información, consulta Anotaciones entre proyectos.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
gcloud
Usa el comando gcloud beta network-management vpc-flow-logs-configs update
.
Los corchetes []
en los siguientes comandos indican parámetros opcionales.
Para actualizar la configuración de los registros de flujo de VPC de una organización, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ --organization=ORGANIZATION \ [--aggregation-interval=AGGREGATION_INTERVAL] \ [--filter-expr=FILTER_EXPRESSION] \ [--flow-sampling=SAMPLING_RATE] \ [--metadata=LOGGING_METADATA] \ [--cross-project-metadata=CROSS_PROJECT_METADATA] \ [--state=STATE]
Por ejemplo, para actualizar el parámetro de intervalo de agregación, ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ --organization=ORGANIZATION \ --aggregation-interval=AGGREGATION_INTERVAL
Reemplaza lo siguiente:
ORGANIZATION
: El ID de la organización.CONFIG_NAME
: Es el nombre de la configuración que deseas actualizar. La configuración se encuentra en el mismo Google Cloud proyecto que el recurso para el que se usa la configuración.
Para actualizar los parámetros opcionales, reemplaza lo siguiente:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
CROSS_PROJECT_METADATA
: Anotaciones entre proyectos. Se puede establecer encross-project-metadata-enabled
(predeterminado) ocross-project-metadata-disabled
. Para obtener más información, consulta Anotaciones entre proyectos.STATE
: Es el estado de la configuración. Puede serenabled
(predeterminado) odisabled
.
API
Usa el método organizations.locations.vpcFlowLogsConfigs.patch
.
Para obtener información sobre los campos que puedes modificar, consulta
Recurso de REST: projects.locations.vpcFlowLogsConfigs.
Para actualizar una configuración de registros de flujo de VPC de una organización, incluye los siguientes parámetros en tu solicitud a la API:
PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS { ...fields to modify }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de cuota. Las solicitudes a la API se registran en este proyecto. El valor de la cuota de la API de Network Management se establece en 1,200 solicitudes por minuto para la cuota a nivel del proyecto y de la organización.ORGANIZATION_ID
: Es el ID de la organización para la que se usa la configuración.CONFIG_NAME
: Es el nombre de la configuración que deseas actualizar.FIELDS
: Es el nombre del campo o los campos que deseas actualizar, separados por comas, por ejemplo,aggregationInterval,flowSampling,metadata
.
Por ejemplo, para actualizar el campo aggregationInterval
de una configuración my-config
en my-organization
, usa la siguiente solicitud a la API:
PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/my-organization/locations/global/vpcFlowLogsConfigs/my-config?updateMask=aggregationInterval { aggregationInterval:AGGREGATION_INTERVAL }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de cuota. Las solicitudes a la API se deducen de este proyecto.AGGREGATION_INTERVAL
con cualquiera de los valores compatibles para este parámetro
Actualiza una configuración a nivel del proyecto
Las configuraciones a nivel del proyecto incluyen configuraciones para redes de VPC (versión preliminar), subredes (versión preliminar), adjuntos de VLAN y túneles de Cloud VPN. Si actualizas la configuración de los registros de flujo de VPC para una red de VPC, se aplicará la configuración modificada a todas las subredes, los adjuntos de VLAN y los túneles de Cloud VPN de la red.
Para actualizar una configuración de registros de flujo de VPC administrada por la API de Compute Engine, consulta Cómo actualizar los parámetros de configuración de las subredes.
Console
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
En la sección Parámetros de configuración a nivel del proyecto, selecciona uno o más parámetros de configuración que quieras actualizar y haz clic en Editar.
Ajusta cualquiera de las siguientes opciones:
- El Intervalo de agregación De forma predeterminada, el intervalo de agregación se establece en 5 s.
- Indica si se debe establecer el Estado de la configuración de los registros de flujo de VPC como activado o desactivado. El estado Activado significa que la configuración de los registros de flujo de VPC seleccionada está activa y genera registros de flujo.
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
100%
significa que se conservan todas las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
También puedes usar el menú
Administrar registros de flujo en las siguientes ubicaciones para editar la configuración de los registros de flujo de VPC:- Las pestañas Redes en el proyecto actual y Subredes en el proyecto actual en la página Redes de VPC
- La pestaña Adjuntos de VLAN en la página Interconexión
- La pestaña Túneles de VPN en la página VPN
gcloud
Usa los comandos gcloud network-management vpc-flow-logs-configs update
y gcloud beta network-management vpc-flow-logs-configs update
.
Los corchetes []
en los siguientes comandos indican parámetros opcionales.
Para actualizar una configuración de registros de flujo de VPC para una red o subred de VPC (versión preliminar), ejecuta el siguiente comando:
gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ [--network=NETWORK | --subnet=SUBNET] \ [--aggregation-interval=AGGREGATION_INTERVAL] \ [--filter-expr=FILTER_EXPRESSION] \ [--flow-sampling=SAMPLING_RATE] \ [--metadata=LOGGING_METADATA] \ [--state=STATE]
Para actualizar la configuración de registros de flujo de VPC para un adjunto de VLAN o un túnel de Cloud VPN, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ [--interconnect-attachment=VLAN_ATTACHMENT | --vpn-tunnel=VPN_TUNNEL] \ [--aggregation-interval=AGGREGATION_INTERVAL] \ [--filter-expr=FILTER_EXPRESSION] \ [--flow-sampling=SAMPLING_RATE] \ [--metadata=LOGGING_METADATA] \ [--state=STATE]
Por ejemplo, para actualizar el parámetro de intervalo de agregación de un adjunto de VLAN o un túnel de Cloud VPN, ejecuta el siguiente comando:
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ --aggregation-interval=AGGREGATION_INTERVAL
Reemplaza lo siguiente:
CONFIG_NAME
: Es el nombre de la configuración que deseas actualizar. La configuración se encuentra en el mismo proyecto Google Cloud que el recurso para el que se usa la configuración.
Para actualizar los parámetros opcionales, reemplaza lo siguiente:
NETWORK
,SUBNET
,VLAN_ATTACHMENT
oVPN_TUNNEL
: Es el nombre del recurso de destino. Solo se puede especificar un recurso por configuración. Usa esta opción para actualizar el nombre del recurso de destino. Debe especificarse con el siguiente formato:- Red de VPC:
projects/PROJECT_ID/global/networks/NAME
- Subred:
projects/PROJECT_ID/regions/REGION/subnetworks/NAME
- Adjunto de VLAN:
projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME
- Túnel de Cloud VPN:
projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME
- Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto Google Cloud que contiene el recurso.REGION
: Es la región del recurso.NAME
: el nombre del recurso.
- Red de VPC:
-
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo que genera esta configuración. Este parámetro se puede establecer eninterval-5-sec
(predeterminada),interval-30-sec
,interval-1-min
,interval-5-min
,interval-10-min
ointerval-15-min
. -
FILTER_EXPRESSION
: Es una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más información, consulta Filtrado de registros. -
SAMPLING_RATE
: La tasa de muestreo de flujo secundario. Este parámetro se puede establecer desde un valor superior a0.0
hasta1.0
(todos los registros, predeterminado). Para obtener más información, consulta Muestreo y procesamiento de registros. -
LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all-metadata
para incluir todas las anotaciones de metadatos (predeterminado). - Usa
exclude-all-metadata
para excluir todas las anotaciones de metadatos. - Usa
custom-metadata
para incluir una lista personalizada de campos de metadatos. Para especificar los campos de metadatos, usa la marca--metadata-fields
:--metadata-fields=METADATA_FIELDS
: reemplazaMETADATA_FIELDS
por una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
. Solo se puede configurar simetadata
se establece comocustom-metadata
.
- Usa
STATE
: Es el estado de la configuración. Puede serenabled
(predeterminado) odisabled
.
API
Usa los métodos projects.locations.vpcFlowLogsConfigs.patch
y projects.locations.vpcFlowLogsConfigs.patch
(v1beta1) .
Para obtener información sobre los campos que puedes modificar, consulta
Recurso de REST: projects.locations.vpcFlowLogsConfigs.
Para actualizar una configuración de registros de flujo de VPC para una red o subred de VPC (versión preliminar), incluye los siguientes parámetros en tu solicitud a la API:
PATCH https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS { ...fields to modify }
Para actualizar una configuración de registros de flujo de VPC para un adjunto de VLAN o un túnel de Cloud VPN, incluye los siguientes parámetros en tu solicitud a la API:
PATCH https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS { ...fields to modify }
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto Google Cloud que contiene la configuración de los registros de flujo de VPC. Este ID es el mismo que el ID del proyecto del recurso para el que se usa la configuración.CONFIG_NAME
: Es el nombre de la configuración que deseas actualizar.FIELDS
: Es el nombre del campo o los campos que deseas actualizar, separados por comas, por ejemplo,aggregationInterval,flowSampling,metadata
.
Por ejemplo, para actualizar el campo aggregationInterval
de una configuración my-config
en my-project
, usa la siguiente solicitud a la API:
PATCH https://networkmanagement.googleapis.com/v1/projects/my-project/locations/global/vpcFlowLogsConfigs/my-config?updateMask=aggregationInterval { aggregationInterval:AGGREGATION_INTERVAL }
Reemplaza AGGREGATION_INTERVAL
por cualquiera de los valores compatibles para este parámetro.
Actualiza los parámetros de configuración de las subredes
En esta sección, se describe cómo actualizar una configuración de registros de flujo de VPC que administra la API de Compute Engine.
Para ver qué parámetros de configuración de los registros de flujo de VPC administra la API de Compute Engine, consulta Visualiza qué subredes en una red tienen habilitados los registros de flujo de VPC.
Console
En la consola de Google Cloud , ve a la página Redes de VPC.
En Subredes del proyecto actual, haz clic en la subred que quieres actualizar.
Haz clic en Editar.
Opcional: Ajusta cualquiera de los siguientes parámetros de configuración:
- El Intervalo de agregación De forma predeterminada, el intervalo de agregación se establece en 5 s.
- Si se debe configurar el filtrado de registros. De forma predeterminada, está deseleccionada la opción Mantener solo los registros que coincidan con un filtro.
- Indica si se deben incluir metadatos en las entradas de registro finales. De forma predeterminada, Anotaciones de metadatos incluye todos los campos.
- La tasa de muestreo secundario.
50%
significa que se conserva la mitad de las entradas que genera el proceso de muestreo de registros de flujo principal. La tasa de muestreo del registro de flujo principal no se puede configurar. Para obtener más información, consulta Muestreo y procesamiento de registros.
Haz clic en Guardar.
Como alternativa, puedes actualizar los parámetros de configuración de los registros de flujo de VPC con el menú Redes de VPC.
Administrar registros de flujo en Subredes en el proyecto actual en la páginagcloud
Ejecuta el siguiente comando:
gcloud compute networks subnets update SUBNET_NAME \ [--logging-aggregation-interval=AGGREGATION_INTERVAL] \ [--logging-flow-sampling=SAMPLING_RATE] \ [--logging-filter-expr=FILTER_EXPRESSION] \ [--logging-metadata=LOGGING_METADATA] \ [--logging-metadata-fields=METADATA_FIELDS] \
Reemplaza lo siguiente:
AGGREGATION_INTERVAL
: El intervalo de agregación para los registros de flujo en esa subred. El intervalo se puede establecer en cualquiera de las siguientes opciones: 5 s (predeterminado), 30 s, 1 min, 5 min, 10 min o 15 min.SAMPLING_RATE
: La tasa de muestreo de flujo secundario. El muestreo de flujo secundario se puede establecer desde0.0
(sin muestreo) hasta1.0
(todos los registros). El valor predeterminado es0.5
. Para obtener más información, consulta Muestreo y procesamiento de registros.FILTER_EXPRESSION
: Una expresión que define qué registros deseas conservar. La expresión tiene un límite de 2,048 caracteres. Para obtener más detalles, consulta Filtrado de registros.LOGGING_METADATA
: Las anotaciones de metadatos que deseas incluir en los registros:- Usa
include-all
para incluir todas las anotaciones de metadatos. - Usa
exclude-all
para excluir todas las anotaciones de metadatos (predeterminado). - Usa
custom
para incluir una lista personalizada de los campos de metadatos que especifiques enMETADATA_FIELDS
.
- Usa
METADATA_FIELDS
: una lista separada por comas de los campos de metadatos que deseas incluir en los registros. Por ejemplo,src_instance,dst_instance
Solo se puede configurar siLOGGING_METADATA
se establece comocustom
.
API
Modifica los campos de muestreo de registros para actualizar los comportamientos de los registros de flujo de VPC.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME { "logConfig": { ...fields to modify }, "fingerprint": "SUBNET_FINGERPRINT" }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto en el que está la subred.REGION
: La región en la que se encuentra la subred.SUBNET_NAME
: el nombre de la subred existente.SUBNET_FINGERPRINT
: Es el ID de huella digital de la subred existente, que se proporciona cuando describes una subred.- Para ver los campos que puedes modificar, consulta Habilita los registros de flujo de VPC cuando creas una subred.
Para obtener más información, consulta el método subnetworks.patch
.
Detén la recopilación de registros
Para pausar la recopilación de registros de un recurso, desactiva todas sus configuraciones activas de registros de flujo de VPC.
Si ya no necesitas una configuración de registros de flujo de VPC, puedes borrarla. La recopilación de registros se detiene y se borra la configuración.
Para detener la recopilación de registros y borrar una configuración de registros de flujo de VPC que administra la API de Compute Engine, consulta Cómo inhabilitar los registros de flujo de VPC en una subred.
Cómo desactivar una configuración de registros de flujo de VPC
Console
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
En las secciones Configuraciones a nivel de la organización o Configuraciones a nivel del proyecto, selecciona una o más configuraciones de registros de flujo de VPC que quieras desactivar y cambia el estado de configuración a Desactivar.
Si tu selección incluye configuraciones activas e inactivas, en el menú Cambiar el estado de configuración, haz clic en Desactivar todo.
gcloud
Para pausar la recopilación de registros de una configuración de registros de flujo de VPC, usa los comandos gcloud network-management vpc-flow-logs-configs update
y gcloud beta network-management vpc-flow-logs-configs update
.
Pausar una configuración a nivel de la organización (versión preliminar)
gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ --organization=ORGANIZATION \ --state=disabled
Reemplaza lo siguiente:
CONFIG_NAME
: Es el nombre de la configuración.ORGANIZATION
: El ID de la organización
Cómo pausar una configuración a nivel del proyecto
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \ --location=global \ --state=disabled
Reemplaza CONFIG_NAME
por el nombre de la configuración.
Para pausar una configuración de registros de flujo de VPC para una red o subred de VPC, usa la versión beta de este comando.
API
Pausar una configuración a nivel de la organización (versión preliminar)
Para pausar la recopilación de registros, usa el método organizations.locations.vpcFlowLogsConfigs.patch
.
PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=state { "state": "DISABLED" }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de cuota. Las solicitudes a la API se registran en este proyecto.ORGANIZATION_ID
: El ID de la organización.CONFIG_NAME
: Es el nombre de la configuración.
Cómo pausar una configuración a nivel del proyecto
Para pausar la recopilación de registros, usa el método projects.locations.vpcFlowLogsConfigs.patch
.
PATCH https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=state { "state": "DISABLED" }
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto Google Cloud que contiene la configuración. Este ID es el mismo que el ID del proyecto del recurso para el que se usa la configuración.CONFIG_NAME
: Es el nombre de la configuración.
Para pausar una configuración de registros de flujo de VPC para una red o subred de VPC, usa la versión v1beta1 de esta solicitud.
Borra una configuración de registros de flujo de VPC
Console
En la Google Cloud consola, ve a la página Registros de flujo de VPC.
En las secciones Configuraciones a nivel de la organización o Configuraciones a nivel del proyecto, selecciona uno o más parámetros de configuración de registros de flujo de VPC que quieras borrar y haz clic en Borrar.
gcloud
Para borrar una configuración de registros de flujo de VPC,
usa los comandos gcloud network-management vpc-flow-logs-configs delete
y gcloud beta network-management vpc-flow-logs-configs delete
.
Cómo borrar una configuración a nivel de la organización (Versión preliminar)
gcloud beta network-management vpc-flow-logs-configs delete CONFIG_NAME \ --location=global \ --organization=ORGANIZATION
Reemplaza lo siguiente:
CONFIG_NAME
: Es el nombre de la configuración.ORGANIZATION
: El ID de la organización
Cómo borrar una configuración a nivel del proyecto
gcloud network-management vpc-flow-logs-configs delete CONFIG_NAME \ --location=global
Reemplaza CONFIG_NAME
por el nombre de la configuración que deseas borrar.
Para borrar una configuración de registros de flujo de VPC para una red o subred de VPC, usa la versión beta de este comando.
API
Cómo borrar una configuración a nivel de la organización (Versión preliminar)
Para borrar una configuración de registros de flujo de VPC, usa el
método organizations.locations.vpcFlowLogsConfigs.delete
.
DELETE -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de cuota. Las solicitudes a la API se registran en este proyecto.ORGANIZATION_ID
: El ID de la organización.CONFIG_NAME
: Es el nombre de la configuración.
Cómo borrar una configuración a nivel del proyecto
Para borrar una configuración de registros de flujo de VPC, usa el
método projects.locations.vpcFlowLogsConfigs.delete
.
DELETE https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
Reemplaza lo siguiente:
PROJECT_ID
: El ID del Google Cloud proyecto que contiene la configuraciónCONFIG_NAME
: Es el nombre de la configuración.
Para borrar una configuración de registros de flujo de VPC para una red o subred de VPC, usa la versión v1beta1 de esta solicitud.
Inhabilita los registros de flujo de VPC en una subred
En esta sección, se describe cómo borrar una configuración de registros de flujo de VPC que administra la API de Compute Engine. Cuando inhabilitas los registros de flujo de VPC en una subred, se detiene la recopilación de registros y se borra la configuración.
Console
En la consola de Google Cloud , ve a la página Redes de VPC.
Haz clic en la subred que quieres actualizar.
Haz clic en Editar.
En Registros de flujo, selecciona Desactivado.
Haz clic en Guardar.
gcloud
Ejecuta el siguiente comando:
gcloud compute networks subnets update SUBNET_NAME \ --no-enable-flow-logs
API
Inhabilita los registros de flujo de VPC en una subred para dejar de recopilar registros.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME { "logConfig": { "enable": false }, "fingerprint": "SUBNET_FINGERPRINT" }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto en el que se encuentra la subred.REGION
: La región en la que se encuentra la subredSUBNET_NAME
: Es el nombre de la subred existente.SUBNET_FINGERPRINT
: Es el ID de huella digital de la subred existente, que se proporciona cuando describes una subred.
Para obtener más información, consulta el método subnetworks.patch
.
Soluciona problemas
Los registros de flujo de las subredes parecen estar inhabilitados aunque los hayas habilitado
Cuando configuras una subred de solo proxy para balanceador de cargas de aplicaciones internos y usas el comando
gcloud compute networks subnets
para habilitar los registros de flujo de VPC, parece que el comando se ejecuta con éxito, pero los registros de flujo en realidad no están habilitados. La marca--enable-flow-logs
no se aplica cuando también incluyes la marca--purpose=INTERNAL_HTTPS_LOAD_BALANCER
.Si usas la Google Cloud consola o la API para habilitar los registros de flujo, verás el mensaje de error: "Valor no válido para el campo ‘resource.enableFlowLogs’: ‘true’. Campo no válido configurado en la subred con el propósito INTERNAL_HTTPS_LOAD_BALANCEER”.
Debido a que las subredes de solo proxy no tienen VMs, no se admiten los registros de flujo de VPC. Este es el comportamiento esperado.