View a markdown version of this page

AWSSupport-CollectElasticBeanstalkLogs - AWS Systems Manager Riferimento al runbook dell’automazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWSSupport-CollectElasticBeanstalkLogs

Descrizione

Il AWSSupport-CollectElasticBeanstalkLogs runbook raccoglie i file di registro AWS Elastic Beanstalk correlati da un'istanza Amazon Elastic Compute Cloud (Amazon EC2) lanciata da Elastic Beanstalk per aiutarti a risolvere i problemi più comuni. Windows Server Mentre l'automazione raccoglie i file di registro associati, vengono apportate modifiche alla struttura del file system, tra cui la creazione di directory temporanee, la copia dei file di registro nelle directory temporanee e la compressione dei file di registro in un archivio. Questa attività può comportare un aumento dell'istanza CPUUtilization Amazon EC2. Per ulteriori informazioniCPUUtilization, consulta le metriche delle istanze nella Amazon CloudWatch User Guide.

Se specifichi un valore per il S3BucketName parametro, l'automazione valuta lo stato della policy del bucket Amazon Simple Storage Service (Amazon S3) specificato. Per contribuire alla sicurezza dei log raccolti dalla tua istanza Amazon EC2, se lo stato della policy isPublic è impostato su o se l'elenco di controllo degli accessi (ACL) concede READ|WRITE autorizzazioni al gruppo predefinito di All Users Amazon S3, i log non vengono caricati. true Per ulteriori informazioni sui gruppi predefiniti di Amazon S3, consulta i gruppi predefiniti di Amazon S3 nella Amazon Simple Storage Service User Guide.

Se non specifichi un valore per il S3BucketName parametro, l'automazione carica il pacchetto di log nel bucket Amazon S3 Elastic Beanstalk predefinito nel punto in cui viene eseguita l'automazione. Regione AWS La directory è denominata secondo la seguente struttura,. elasticbeanstalk- region - accountID accountIDI valori region e saranno diversi in base alla regione in Account AWS cui viene eseguita l'automazione. Il pacchetto di log verrà salvato nella resources/environments/logs/bundle/ environmentID / instanceID directory. instanceIDI valori environmentID e saranno diversi in base all'ambiente Elastic Beanstalk e all'istanza Amazon EC2 da cui stai raccogliendo i log.

Per impostazione predefinita, il profilo dell'istanza AWS Identity and Access Management (IAM) collegato alle istanze Amazon EC2 dell'ambiente Elastic Beanstalk dispone delle autorizzazioni necessarie per caricare il pacchetto nel bucket Amazon S3 Elastic Beanstalk predefinito per il tuo ambiente. Se si specifica un valore per il S3BucketName parametro, il profilo dell'istanza collegato all'istanza Amazon EC2 deve consentire le azioni,, e per il bucket e il s3:GetBucketAcl percorso Amazon S3 specificati. s3:GetBucketPolicy s3:GetBucketPolicyStatus s3:PutObject

Nota

Questa automazione richiede almeno 500 MB di spazio su disco disponibile sul volume principale di Amazon Elastic Block Store (Amazon EBS) collegato all'istanza Amazon EC2. Se non c'è abbastanza spazio disponibile su disco nel volume principale, l'automazione si interrompe.

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

Windows

Parametri

  • AutomationAssumeRole

    Tipo: String

    Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

  • EnvironmentId

    Tipo: String

    Descrizione: (Obbligatorio) L'ID dell'ambiente Elastic Beanstalk da cui desideri raccogliere il pacchetto di log.

  • InstanceId

    Tipo: String

    (Obbligatorio) L'ID dell'istanza Amazon EC2 nell'ambiente Elastic Beanstalk da cui desideri raccogliere il pacchetto di log.

  • S3BucketName

    Tipo: String

    (Facoltativo) Il bucket Amazon S3 in cui desideri caricare i log archiviati.

  • S3BucketPath

    Tipo: String

    (Facoltativo) Il percorso del bucket Amazon S3 in cui desideri caricare il pacchetto di log. Questo parametro viene ignorato se non si specifica un valore per il parametro. S3BucketName

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:SendCommand

  • ssm:DescribeInstanceInformation

  • ec2:DescribeInstances

Fasi del documento

  • aws:assertAwsResourceProperty- Conferma che l'istanza Amazon EC2 specificata nel InstanceId parametro è gestita da. AWS Systems Manager

  • aws:assertAwsResourceProperty- Conferma che l'istanza Amazon EC2 specificata nel InstanceId parametro è un'Windows Serveristanza.

  • aws:runCommand- Verifica se l'istanza fa parte di un ambiente Elastic Beanstalk, se c'è spazio su disco sufficiente per raggruppare i log e se il bucket Amazon S3 in cui verranno caricati i log è pubblico.

  • aws:runCommand- Raccoglie i file di log e carica l'archivio nel bucket Amazon S3 specificato nel S3BucketName parametro o nel bucket predefinito per l'ambiente Elastic Beanstalk se non viene specificato un valore.