View a markdown version of this page

AWSSupport-TroubleshootOpenSearchRedYellowCluster - AWS Systems Manager Referencia del manual de procedimientos de Automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSSupport-TroubleshootOpenSearchRedYellowCluster

Descripción

AWSSupport-TroubleshootOpenSearchRedYellowClusterEl manual de automatización se utiliza para identificar la causa del estado de los clústeres de color rojo o amarillo y guiarte para cambiar el clúster de nuevo a verde.

¿Cómo funciona?

El manual le AWSSupport-TroubleshootOpenSearchRedYellowCluster ayuda a solucionar la causa del clúster rojo o amarillo y proporciona los pasos siguientes para resolver este problema mediante el análisis de la configuración del clúster y la utilización de los recursos.

El manual lleva a cabo los siguientes pasos:

  • Llama a la DescribeDomain API desde el dominio de destino para obtener la configuración del clúster.

  • Comprueba si el dominio del OpenSearch servicio está basado en Internet (público) o en Amazon Virtual Private Cloud (VPC).

  • Crea una función pública o de Amazon en VPC-based AWS Lambda función de la configuración del clúster. Nota: La función Lambda contiene el código de solución de problemas que ejecuta las API de OpenSearch servicio en el clúster para determinar por qué el clúster está en estado rojo o amarillo.

  • Elimina la función Lambda.

  • Muestra las comprobaciones realizadas y los siguientes pasos recomendados para resolver el problema del clúster rojo o amarillo.

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux, macOS, Windows

Parámetros

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • cloudformation:CreateStack

  • cloudformation:DescribeStacks

  • cloudformation:DescribeStackEvents

  • cloudformation:DeleteStack

  • lambda:CreateFunction

  • lambda:DeleteFunction

  • lambda:InvokeFunction

  • lambda:GetFunction

  • es:DescribeDomain

  • es:DescribeDomainConfig

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeVpcs

  • ec2:DescribeNetworkInterfaces

  • ec2:CreateNetworkInterface

  • ec2:DeleteNetworkInterface

  • ec2:DescribeInstances

  • ec2:AttachNetworkInterface

  • cloudwatch:GetMetricData

  • iam:PassRole

El LambdaExecutionRole parámetro requiere las siguientes acciones para utilizar correctamente el runbook:

  • es:ESHttpGet

  • ec2:CreateNetworkInterface

  • ec2:DescribeNetworkInterfaces

  • ec2:DeleteNetworkInterface

Descripción general de la LambdaExecutionRole política:

El siguiente es un ejemplo del rol de ejecución de una función de Lambda (rol AWS Identity and Access Management (IAM)) que otorga a la función permiso para acceder a los AWS servicios y recursos que requiere este libro de ejecución. Para obtener más información, consulte Rol de ejecución de Lambda.

nota

ec2:DeleteNetworkInterfaceLos y solo son necesarios si su clúster de OpenSearch servicios es Amazon VPC-based para permitir que la función Lambda cree y administre las interfaces de red de Amazon VPC. ec2:DescribeNetworkInterfaces ec2:CreateNetworkInterface Para obtener más información, consulte Conectar las redes salientes a los recursos en una función de ejecución de Amazon VPC y Lambda.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "es:ESHttpGet",
            "Resource": [
                "arn:aws:es:us-east-1:111122223333:domain/domain-name/",
                "arn:aws:es:us-east-1:111122223333:domain/domain-name/_cluster/health",
                "arn:aws:es:us-east-1:111122223333:domain/domain-name/_cat/indices",
                "arn:aws:es:us-east-1:111122223333:domain/domain-name/_cat/allocation",
                "arn:aws:es:us-east-1:111122223333:domain/domain-name/_cluster/allocation/explain"
            ]
        },
        {
            "Condition": {
                "ArnLikeIfExists": {
                    "ec2:Vpc": "arn:aws:ec2:us-east-1:111122223333:vpc/vpc_id"
                }
            },
            "Action": [
                "ec2:DeleteNetworkInterface",
                "ec2:CreateNetworkInterface",
                "ec2:DescribeNetworkInterfaces",
                "ec2:UnassignPrivateIpAddresses",
                "ec2:AssignPrivateIpAddresses"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta la consola AWSSupport-TroubleshootOpenSearchRedYellowCluster. AWS Systems Manager

  2. Elija Execute automation (Ejecutar automatización).

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      El nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

    • LambdaExecutionRole (Obligatorio):

      El ARN del rol de IAM que utilizará Lambda para firmar las solicitudes en su clúster de Amazon OpenSearch Service.

    • DomainName (Obligatorio):

      El nombre del dominio del OpenSearch servicio con el estado del clúster en rojo o amarillo.

    • UtilizationThreshold (Opcional):

      El porcentaje del umbral de utilización utilizado para comparar el uso de la CPU y JVMMemoryPressure las métricas. El valor predeterminado es 80.

    Formulario de parámetros de entrada con campos para AutomationAssumeRole LambdaExecutionRole, DomainName, y UtilizationThreshold.

  4. Si ha habilitado un control de acceso detallado en un clúster de OpenSearch servicios, asegúrese de que el LambdaExecutionRole rol arn esté asignado a un rol con al menos permiso. cluster_monitor

    La pestaña de permisos muestra la sección de Clúster permisos con el permiso cluster_monitor seleccionado.
    El campo de roles de backend muestra un ARN de AWS IAM rol con el botón Eliminar y el botón Mapear.

  5. Seleccione Ejecutar.

  6. Se inicia la automatización.

  7. El manual de procedimientos de automatización realiza los siguientes pasos:

    • GetClusterConfiguration:

      Obtiene la configuración del clúster de OpenSearch servicios.

    • CreateAWSLambdaFunctionStack:

      Crea una función Lambda temporal en su cuenta usando. CloudFormation La función Lambda se usa para ejecutar las API de OpenSearch servicio.

    • WaitForAWSLambdaFunctionStack:

      Espera a que se complete la CloudFormation pila.

    • GetClusterMetricsFromCloudWatch:

      Obtiene las métricas relacionadas con los clústeres de Amazon CloudWatch ClusterStatus, CPUUtilization y JVMMemoryPressure OpenSearch Service, así como su fecha de creación.

    • RunOpenSearchAPIs:

      Utiliza la función Lambda para llamar a las API de OpenSearch servicio y analizar los datos de las métricas del clúster a fin de diagnosticar la causa del estado del clúster en rojo o amarillo.

    • DeleteAWSLambdaFunctionStack:

      Elimina de su cuenta la función Lambda creada por esta automatización.

  8. Una vez finalizada, consulte la sección de resultados para ver los resultados detallados de la ejecución.

    • RootCause:

      Proporciona una descripción general de la causa identificada por la que el estado del clúster aparece en rojo o amarillo.

    • IssueDescription:

      Proporciona detalles sobre por qué el clúster está en estado rojo o amarillo y los posibles pasos para devolverlo al estado verde.

Referencias

Automatización de Systems Manager

AWS documentación de servicio