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
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 porta24224nel gruppo di sicurezza utilizzato dall'attività. Per attività che utilizzano la modalità di reteawsvpc, questo è il gruppo di sicurezza associato all'attività. Per attività che utilizzano la modalità di retehost, questo è il gruppo di sicurezza associato all'istanza Amazon EC2 che ospita l'attività. Per attività che utilizzano la modalità di retebridge, non creare mappature di porte che utilizzano la porta24224. -
Per le attività che utilizzano il
bridgemodalità 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.NotaSe si utilizzano i parametri delle condizioni di dipendenza nelle definizioni dei contenitori con un FireLens configurazione, assicurati che ogni contenitore abbia un
STARToHEALTHYrequisito 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-metadatasufalsenella sezionefirelensConfigurationdella 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
uidper 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.0e versioni successive e Amazon ECS-optimized versione AMIv20250716e più tardi. -
Quando si specifica un utente per FireLens contenitore, il
uiddeve 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.