View a markdown version of this page

Invia i log di Amazon ECS a un AWS servizio o AWS Partner - Amazon Elastic Container Service

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à.

Invia i log di Amazon ECS a un AWS servizio o AWS Partner

Puoi usare FireLens affinché Amazon ECS utilizzi i parametri di definizione delle attività per indirizzare i log a un AWS servizio o AWS Partner Network destinazione (APN) per l'archiviazione e l'analisi dei log. La AWS Partner Network è una comunità globale di partner che sfrutta programmi, competenze e risorse per creare, commercializzare e vendere offerte ai clienti. Per ulteriori informazioni, consulta AWS Partner. FireLens funziona con Fluentd e Fluent Bit. Forniamo l'immagine AWS for Fluent Bit oppure puoi utilizzare la tua immagine Fluentd o Fluent Bit.

Per impostazione predefinita, Amazon ECS configura la dipendenza del container in modo che il container Firelens si avvii prima di qualsiasi container che lo utilizza. Inoltre, il container Firelens si ferma dopo che tutti i container che lo utilizzano si fermano.

Per utilizzare questa funzionalità, devi creare un ruolo IAM per le tue attività che fornisca le autorizzazioni necessarie per utilizzarle AWS servizi richiesti dalle attività. Ad esempio, se un container esegue il routing dei log a Firehose, allora l'attività richiede l'autorizzazione per chiamare l'API firehose:PutRecordBatch. Per ulteriori informazioni, consulta Aggiunta e rimozione di autorizzazioni per identità IAM nella Guida per l'utente di IAM.

Il processo potrebbe richiedere anche il ruolo di esecuzione del processo di Amazon ECS nelle seguenti condizioni. Per ulteriori informazioni, consulta Ruolo IAM di esecuzione di attività Amazon ECS.

  • Se la tua attività è ospitata su Fargate e stai recuperando immagini di contenitori da Amazon ECR o fai riferimento a dati sensibili da AWS Secrets Manager nella configurazione del registro, devi includere il ruolo IAM di esecuzione dell'attività.

  • Quando si utilizza un file di configurazione personalizzato ospitato in Amazon S3, il ruolo IAM per l'esecuzione dell'attività deve includere l'autorizzazione s3:GetObject.

Considera quanto segue quando usi FireLens per Amazon ECS:

  • Consigliamo di aggiungere my_service_ al log del nome del container in modo da poter distinguere facilmente i nomi dei container nella console.

  • Per impostazione predefinita, Amazon ECS aggiunge una dipendenza dall'ordine iniziale del container tra i container dell'applicazione e il container FireLens. Quando si specifica un ordine del container tra i container dell'applicazione e il container FireLens, l'ordine di avvio predefinito del container viene sovrascritto.

  • FireLens per Amazon ECS è supportato per le attività ospitate sia su AWS Fargate su Linux che su Amazon EC2 su Linux. I container di Windows non supportano FireLens.

    Per informazioni su come configurare la registrazione centralizzata per i container di Windows, consulta Registrazione centralizzata per container di Windows su Amazon ECS tramite Fluent Bit.

  • Puoi usare CloudFormation modelli da configurare FireLens per Amazon ECS. Per ulteriori informazioni, consulta AWS: :ECS:TaskDefinition FirelensConfiguration nel AWS CloudFormation Guida per l'utente

  • FireLens ascolta sulla porta 24224, in modo da garantire che il FireLens il router di log non è raggiungibile al di fuori dell'attività, non è necessario consentire il traffico in entrata sulla porta 24224 nel gruppo di sicurezza utilizzato dall'attività. Per attività che utilizzano la modalità di rete awsvpc, questo è il gruppo di sicurezza associato all'attività. Per attività che utilizzano la modalità di rete host, questo è il gruppo di sicurezza associato all'istanza Amazon EC2 che ospita l'attività. Per attività che utilizzano la modalità di rete bridge, non creare mappature di porte che utilizzano la porta 24224.

  • Per le attività che utilizzano il bridge modalità di rete, il contenitore con FireLens la configurazione deve iniziare prima dell'avvio di qualsiasi contenitore applicativo che si basa su di essa. Per controllare l'ordine di avvio dei container, utilizza le condizioni di dipendenza nella definizione di attività. Per ulteriori informazioni, consulta Dipendenze per i container.

    Nota

    Se si utilizzano i parametri delle condizioni di dipendenza nelle definizioni dei contenitori con un FireLens configurazione, assicurati che ogni contenitore abbia un START o HEALTHY requisito della condizione.

  • Per impostazione predefinita, FireLens aggiunge il nome della definizione del cluster e dell'attività e l'Amazon Resource Name (ARN) del cluster come chiavi di metadati al tuo stdout/stderr registri dei contenitori. Di seguito è riportato un esempio del formato dei metadati.

    "ecs_cluster": "cluster-name", "ecs_task_arn": "arn:aws:ecs:region:111122223333:task/cluster-name/f2ad7dba413f45ddb4EXAMPLE", "ecs_task_definition": "task-def-name:revision",

    Se non desideri i metadati nei tuoi log, imposta enable-ecs-log-metadata su false nella sezione firelensConfiguration della definizione di attività.

    "firelensConfiguration":{ "type":"fluentbit", "options":{ "enable-ecs-log-metadata":"false", "config-file-type":"file", "config-file-value":"/extra.conf" }

È possibile configurare il FireLens contenitore da eseguire come utente non root. Considera i seguenti aspetti:

  • Per configurare FireLens contenitore da eseguire come utente non root, è necessario specificare l'utente in uno dei seguenti formati:

    • uid

    • uid:gid

    • uid:group

    Per ulteriori informazioni sulla specificazione di un utente in una definizione di contenitore, vedere ContainerDefinition nel Riferimento all'API Amazon Elastic Container Service.

    Il FireLens il contenitore riceve i registri delle applicazioni tramite un UNIX presa. L'agente Amazon ECS utilizza uid per assegnare la proprietà della directory socket a FireLens contenitore.

  • Configurazione del FireLens il contenitore da eseguire come utente non root è supportato nella versione Amazon ECS Agent 1.96.0 e versioni successive e Amazon ECS-optimized versione AMI v20250716 e più tardi.

  • Quando si specifica un utente per FireLens contenitore, il uid deve essere unico e non utilizzato per altri processi appartenenti ad altri contenitori nell'attività o nell'istanza del contenitore.

Per informazioni su come utilizzare più file di configurazione con Amazon ECS, inclusi i file ospitati o i file in Amazon S3, consultare Init process for Fluent Bit on ECS, multi-config support.

Per informazioni sulle configurazioni di esempio, vedere Esempio di definizione di attività di Amazon ECS: routing logs verso FireLens.

Per ulteriori informazioni sulla configurazione dei log per un throughput elevato, vedere Configurazione dei log di Amazon ECS per un throughput elevato.