Concatenazione di messaggi di log Amazon multilinea o traccia dello stack ECS

Per utilizzare l'editor della JSON policy per creare una policy.

1. Accedi a AWS Management Console e apri la IAM console all'indirizzo https://console.aws.amazon.com/iam/.

2. Nel riquadro di navigazione a sinistra, seleziona Policies (Policy).

   Se è la prima volta che selezioni Policy, verrà visualizzata la pagina Benvenuto nelle policy gestite. Seleziona Inizia.

3. Nella parte superiore della pagina, scegli Crea policy.

4. Nella sezione Policy editor, scegli l'JSONopzione.

5. Inserisci il documento di JSON policy seguente:

   {
   	"Version": "2012-10-17",
   	"Statement": [{
   		"Effect": "Allow",
   		"Action": [
   			"logs:CreateLogStream",
   			"logs:CreateLogGroup",
   			"logs:PutLogEvents"
   		],
   		"Resource": "*"
   	}]
   }

6. Scegli Next (Successivo).

   Nota

   È possibile passare dall'opzione Visual a quella dell'JSONeditor in qualsiasi momento. Se tuttavia si apportano modifiche o se si seleziona Successivo nell'editor Visivo, IAM potrebbe ristrutturare la policy per ottimizzarla per l'editor visivo. Per ulteriori informazioni, consulta la sezione Ristrutturazione delle politiche nella Guida per l'IAMutente.

7. Nella pagina Rivedi e crea, immettere un valore in Nome policy e Descrizione (facoltativo) per la policy in fase di creazione. Rivedi Autorizzazioni definite in questa policy per visualizzare le autorizzazioni concesse dalla policy.

8. Seleziona Crea policy per salvare la nuova policy.

Creare e caricare l'immagine per un container Fluent Bit

Questa immagine includerà il file parser in cui si specifica l'espressione regolare e un file di configurazione che fa riferimento al file parser.

1. Crea una cartella con il nome FluentBitDockerImage.

2. Nella cartella, crea il file parser contenente le regole per analizzare il log e concatenare le righe che appartengono allo stesso messaggio.

   1. Incolla i contenuti seguenti nel file parser:

      [MULTILINE_PARSER]
          name          multiline-regex-test
          type          regex
          flush_timeout 1000
          #
          # Regex rules for multiline parsing
          # ---------------------------------
          #
          # configuration hints:
          #
          #  - first state always has the name: start_state
          #  - every field in the rule must be inside double quotes
          #
          # rules |   state name  | regex pattern                  | next state
          # ------|---------------|--------------------------------------------
          rule      "start_state"   "/(Dec \d+ \d+\:\d+\:\d+)(.*)/"  "cont"
          rule      "cont"          "/^\s+at.*/"                     "cont"

      Mentre personalizzi il modello di regex, ti consigliamo di utilizzare un editor di espressioni regolari per provare l'espressione.

   2. Salva il file con nome parsers_multiline.conf.

3. All'interno della cartella FluentBitDockerImage, crea un file di configurazione personalizzato che fa riferimento al file parser creato nel passaggio precedente.

   Per ulteriori informazioni sul file di configurazione personalizzato, consulta Specifica di un file di configurazione personalizzato nella Guida per gli sviluppatori di Amazon Elastic Container Service

   1. Incolla i contenuti seguenti nel file:

      [SERVICE]
          flush                 1
          log_level             info
          parsers_file          /parsers_multiline.conf
          
      [FILTER]
          name                  multiline
          match                 *
          multiline.key_content log
          multiline.parser      multiline-regex-test

      Nota

      È necessario utilizzare il percorso assoluto del parser.

   2. Salva il file con nome extra.conf.

4. All'interno della cartella FluentBitDockerImage, crea il Dockerfile con l'immagine Fluent Bit e il parser e i file di configurazione creati.

   1. Incolla i contenuti seguenti nel file:

      FROM public.ecr.aws/aws-observability/aws-for-fluent-bit:latest
      
      ADD parsers_multiline.conf /parsers_multiline.conf
      ADD extra.conf /extra.conf

   2. Salva il file con nome Dockerfile.

5. Utilizzando il Dockerfile, crea un'immagine Fluent Bit personalizzata con il parser e i file di configurazione personalizzati inclusi.

   Nota

   Puoi posizionare il file parser e il file di configurazione in qualsiasi punto dell'immagine Docker, eccetto /fluent-bit/etc/fluent-bit.conf quando questo percorso del file viene utilizzato da. FireLens

   1. Crea l'immagine: docker build -t fluent-bit-multiline-image .

      Dove: fluent-bit-multiline-image è il nome dell'immagine in questo esempio.

   2. Verifica che l'immagine sia stata creata correttamente: docker images —filter reference=fluent-bit-multiline-image

      In caso di esito positivo, l'output mostra l'immagine e il tag latest.

6. Carica l'immagine Fluent Bit personalizzata in Amazon Elastic Container Registry.

   1. Crea un ECR repository Amazon per archiviare l'immagine: aws ecr create-repository --repository-name fluent-bit-multiline-repo --region us-east-1

      Dove: fluent-bit-multiline-repo è il nome del repository e us-east-1 è la regione in questo esempio.

      L'output fornisce i dettagli del nuovo repository.

   2. Applica un tag all'immagine con il valore repositoryUri ricavato dall'output precedente: docker tag fluent-bit-multiline-image repositoryUri

      Esempio: docker tag fluent-bit-multiline-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

   3. Esegui l'immagine Docker per verificare che sia stata eseguita correttamente: docker images —filter reference=repositoryUri

      Nell'output, il nome del repository cambia da fluent-bit-multiline-repo a. repositoryUri

   4. Effettua l'autenticazione su Amazon ECR eseguendo il aws ecr get-login-password comando e specificando l'ID del registro su cui desideri autenticarti: aws ecr get-login-password | docker login --username AWS --password-stdin registry ID.dkr.ecr.region.amazonaws.com

      Esempio: ecr get-login-password | docker login --username AWS --password-stdin xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com

      Viene visualizzato un messaggio di accesso riuscito.

   5. Invia l'immagine ad AmazonECR: docker push registry ID.dkr.ecr.region.amazonaws.com/repository name

      Esempio: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

Crea e carica l'immagine per un'applicazione demo multilinea

Questa immagine includerà un file di script Python che esegue l'applicazione e un file di log di esempio.

Quando esegui il processo, l'applicazione simula le esecuzioni, quindi fallisce e crea una traccia dello stack.

1. Crea una cartella denominata multiline-app: mkdir multiline-app

2. Crea un file di script Python.

   1. Nella cartella multiline-app, crea un file con il nome main.py.

   2. Incolla i contenuti seguenti nel file:

      import os
      import time
      file1 = open('/test.log', 'r')
      Lines = file1.readlines()
       
      count = 0
      
      for i in range(10):
          print("app running normally...")
          time.sleep(1)
      
      # Strips the newline character
      for line in Lines:
          count += 1
          print(line.rstrip())
      print(count)
      print("app terminated.")
                                      

   3. Salvare il file main.py.

3. Crea un file di log di esempio.

   1. Nella cartella multiline-app, crea un file con il nome test.log.

   2. Incolla i contenuti seguenti nel file:

      single line...
      Dec 14 06:41:08 Exception in thread "main" java.lang.RuntimeException: Something has gone wrong, aborting!
          at com.myproject.module.MyProject.badMethod(MyProject.java:22)
          at com.myproject.module.MyProject.oneMoreMethod(MyProject.java:18)
          at com.myproject.module.MyProject.anotherMethod(MyProject.java:14)
          at com.myproject.module.MyProject.someMethod(MyProject.java:10)
          at com.myproject.module.MyProject.main(MyProject.java:6)
      another line...
      

   3. Salvare il file test.log.

4. All'interno della cartella multiline-app, crea il Dockerfile.

   1. Incolla i contenuti seguenti nel file:

      FROM public.ecr.aws/amazonlinux/amazonlinux:latest
      ADD test.log /test.log
      
      RUN yum upgrade -y && yum install -y python3
      
      WORKDIR /usr/local/bin
      
      COPY main.py .
      
      CMD ["python3", "main.py"]

   2. Salvare il file Dockerfile.

5. Usando il Dockerfile, crea un'immagine.

   1. Crea l'immagine: docker build -t multiline-app-image .

      Dove: multiline-app-image è il nome dell'immagine in questo esempio.

   2. Verifica che l'immagine sia stata creata correttamente: docker images —filter reference=multiline-app-image

      In caso di esito positivo, l'output mostra l'immagine e il tag latest.

6. Carica l'immagine nel registro del container Amazon Elastic.

   1. Crea un ECR repository Amazon per archiviare l'immagine: aws ecr create-repository --repository-name multiline-app-repo --region us-east-1

      Dove: multiline-app-repo è il nome del repository e us-east-1 è la regione in questo esempio.

      L'output fornisce i dettagli del nuovo repository. Annota il valore repositoryUri poiché sarà necessario nei passaggi successivi.

   2. Applica un tag all'immagine con il valore repositoryUri ricavato dall'output precedente: docker tag multiline-app-image repositoryUri

      Esempio: docker tag multiline-app-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

   3. Esegui l'immagine Docker per verificare che sia stata eseguita correttamente: docker images —filter reference=repositoryUri

      Nell'output, il nome del repository cambia da multiline-app-repo al valore repositoryUri.

   4. Invia l'immagine ad AmazonECR: docker push aws_account_id.dkr.ecr.region.amazonaws.com/repository name

      Esempio: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

Crea la definizione di un processo e avviare il processo

1. Crea un file di definizione del processo con il nome del file multiline-task-definition.json.

2. Incolla i contenuti seguenti nel file multiline-task-definition.json:

   {
       "family": "firelens-example-multiline",
       "taskRoleArn": "task role ARN,
       "executionRoleArn": "execution role ARN",
       "containerDefinitions": [
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-image:latest",
               "name": "log_router",
               "firelensConfiguration": {
                   "type": "fluentbit",
                   "options": {
                       "config-file-type": "file",
                       "config-file-value": "/extra.conf"
                   }
               },
               "memoryReservation": 50
           },
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/multiline-app-image:latest",
               "name": "app",
               "logConfiguration": {
                   "logDriver": "awsfirelens",
                   "options": {
                       "Name": "cloudwatch_logs",
                       "region": "us-east-1",
                       "log_group_name": "multiline-test/application",
                       "auto_create_group": "true",
                       "log_stream_prefix": "multiline-"
                   }
               },
               "memoryReservation": 100
           }
       ],
       "requiresCompatibilities": ["FARGATE"],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512"
   }

   Sostituisci quanto segue nella definizione del processo multiline-task-definition.json:

   1. task role ARN

      Per trovare il ruolo dell'attivitàARN, vai alla IAM Console. Scegli Roles (Roli) e trova il ruolo del processo ecs-task-role-for-firelens che hai creato. Scegli il ruolo e copia ARNquello che appare nella sezione Riepilogo.

   2. execution role ARN

      Per trovare il ruolo di esecuzioneARN, vai alla IAM Console. Scegli Roles (Ruoli) e trova il ruolo ecsTaskExecutionRole. Scegli il ruolo e copia ARNquello che appare nella sezione Riepilogo.

   3. aws_account_id

      Per trovare l'aws_account_id, accedi alla AWS Management Console. Scegli il tuo nome utente in alto a destra e copia il tuo ID account.

   4. us-east-1

      Sostituisci la regione se necessario.

3. Registra il file di definizione del processo: aws ecs register-task-definition --cli-input-json file://multiline-task-definition.json --region region

4. Apri la console nella https://console.aws.amazon.com/ecs/versione 2.

5. Nel pannello di navigazione, scegli Task Definitions (Definizioni dei processi) quindi scegli la famiglia firelens-example-multiline, perché sopra abbiamo registrato la definizione dell'attività processo in questa famiglia nella prima riga della definizione del processo.

6. Scegli la versione più recente.

7. Scegli Distribuisci, Esegui attività.

8. Nella pagina Esegui attività, in Cluster scegli il cluster, quindi in Reti scegli le sottoreti disponibili per tale attività in Sottoreti.

9. Scegli Create (Crea) .

Verifica che i messaggi di log multilinea in Amazon CloudWatch appaiano concatenati

1. Apri la console all'indirizzo. CloudWatch https://console.aws.amazon.com/cloudwatch/

2. Nel pannello di navigazione, espandi Logs (Log) e scegli Log groups (Gruppi di log).

3. Scegli il gruppo di log multiline-test/applicatio.

4. Scegli il log. Visualizza i messaggi. Le righe che corrispondono alle regole nel file parser vengono concatenate e appaiono come un singolo messaggio.

   Il seguente frammento di log mostra le righe concatenate in un singolo evento di traccia dello stack Java:

   {
       "container_id": "xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "log": "Dec 14 06:41:08 Exception in thread \"main\" java.lang.RuntimeException: Something has gone wrong, aborting!\n    at com.myproject.module.MyProject.badMethod(MyProject.java:22)\n    at com.myproject.module.MyProject.oneMoreMethod(MyProject.java:18)\n    at com.myproject.module.MyProject.anotherMethod(MyProject.java:14)\n    at com.myproject.module.MyProject.someMethod(MyProject.java:10)\n    at com.myproject.module.MyProject.main(MyProject.java:6)",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:2"
   }

   Il seguente frammento di log mostra come viene visualizzato lo stesso messaggio con una singola riga se esegui un ECS container Amazon non configurato per concatenare messaggi di log multilinea.

   {
       "log": "Dec 14 06:41:08 Exception in thread \"main\" java.lang.RuntimeException: Something has gone wrong, aborting!",
       "container_id": "xxxxxx-xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:3"
   }

Crea e carica l'immagine per un container Fluent Bit

Questa immagine includerà un file di configurazione che fa riferimento al parser Fluent Bit.

1. Crea una cartella con il nome FluentBitDockerImage.

2. All'interno della cartella FluentBitDockerImage, crea un file di configurazione personalizzato che fa riferimento al file parser integrato Fluent Bit.

   Per ulteriori informazioni sul file di configurazione personalizzato, consulta Specifica di un file di configurazione personalizzato nella Guida per gli sviluppatori di Amazon Elastic Container Service

   1. Incolla i contenuti seguenti nel file:

      [FILTER]
          name                  multiline
          match                 *
          multiline.key_content log
          multiline.parser      go

   2. Salva il file con nome extra.conf.

3. All'interno della cartella FluentBitDockerImage, crea il Dockerfile con l'immagine Fluent Bit e il parser e i file di configurazione creati.

   1. Incolla i contenuti seguenti nel file:

      FROM public.ecr.aws/aws-observability/aws-for-fluent-bit:latest
      ADD extra.conf /extra.conf

   2. Salva il file con nome Dockerfile.

4. Utilizzando il Dockerfile, crea un'immagine Fluent Bit personalizzata con il file di configurazione personalizzato inclusi.

   Nota

   Puoi posizionare il file di configurazione in qualsiasi punto dell'immagine Docker, eccetto /fluent-bit/etc/fluent-bit.conf quando questo percorso del file viene utilizzato da FireLens.

   1. Crea l'immagine: docker build -t fluent-bit-multiline-image .

      Dove: fluent-bit-multiline-image è il nome dell'immagine in questo esempio.

   2. Verifica che l'immagine sia stata creata correttamente: docker images —filter reference=fluent-bit-multiline-image

      In caso di esito positivo, l'output mostra l'immagine e il tag latest.

5. Carica l'immagine Fluent Bit personalizzata in Amazon Elastic Container Registry.

   1. Crea un ECR repository Amazon per archiviare l'immagine: aws ecr create-repository --repository-name fluent-bit-multiline-repo --region us-east-1

      Dove: fluent-bit-multiline-repo è il nome del repository e us-east-1 è la regione in questo esempio.

      L'output fornisce i dettagli del nuovo repository.

   2. Applica un tag all'immagine con il valore repositoryUri ricavato dall'output precedente: docker tag fluent-bit-multiline-image repositoryUri

      Esempio: docker tag fluent-bit-multiline-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

   3. Esegui l'immagine Docker per verificare che sia stata eseguita correttamente: docker images —filter reference=repositoryUri

      Nell'output, il nome del repository cambia da fluent-bit-multiline-repo a. repositoryUri

   4. Effettua l'autenticazione su Amazon ECR eseguendo il aws ecr get-login-password comando e specificando l'ID del registro su cui desideri autenticarti: aws ecr get-login-password | docker login --username AWS --password-stdin registry ID.dkr.ecr.region.amazonaws.com

      Esempio: ecr get-login-password | docker login --username AWS --password-stdin xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com

      Viene visualizzato un messaggio di accesso riuscito.

   5. Invia l'immagine ad AmazonECR: docker push registry ID.dkr.ecr.region.amazonaws.com/repository name

      Esempio: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

Crea e carica l'immagine per un'applicazione demo multilinea

Questa immagine includerà un file di script Python che esegue l'applicazione e un file di log di esempio.

1. Crea una cartella denominata multiline-app: mkdir multiline-app

2. Crea un file di script Python.

   1. Nella cartella multiline-app, crea un file con il nome main.py.

   2. Incolla i contenuti seguenti nel file:

      import os
      import time
      file1 = open('/test.log', 'r')
      Lines = file1.readlines()
       
      count = 0
      
      for i in range(10):
          print("app running normally...")
          time.sleep(1)
      
      # Strips the newline character
      for line in Lines:
          count += 1
          print(line.rstrip())
      print(count)
      print("app terminated.")
                                      

   3. Salvare il file main.py.

3. Crea un file di log di esempio.

   1. Nella cartella multiline-app, crea un file con il nome test.log.

   2. Incolla i contenuti seguenti nel file:

      panic: my panic
      
      goroutine 4 [running]:
      panic(0x45cb40, 0x47ad70)
        /usr/local/go/src/runtime/panic.go:542 +0x46c fp=0xc42003f7b8 sp=0xc42003f710 pc=0x422f7c
      main.main.func1(0xc420024120)
        foo.go:6 +0x39 fp=0xc42003f7d8 sp=0xc42003f7b8 pc=0x451339
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003f7e0 sp=0xc42003f7d8 pc=0x44b4d1
      created by main.main
        foo.go:5 +0x58
      
      goroutine 1 [chan receive]:
      runtime.gopark(0x4739b8, 0xc420024178, 0x46fcd7, 0xc, 0xc420028e17, 0x3)
        /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc420053e30 sp=0xc420053e00 pc=0x42503c
      runtime.goparkunlock(0xc420024178, 0x46fcd7, 0xc, 0x1000f010040c217, 0x3)
        /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc420053e70 sp=0xc420053e30 pc=0x42512e
      runtime.chanrecv(0xc420024120, 0x0, 0xc420053f01, 0x4512d8)
        /usr/local/go/src/runtime/chan.go:506 +0x304 fp=0xc420053f20 sp=0xc420053e70 pc=0x4046b4
      runtime.chanrecv1(0xc420024120, 0x0)
        /usr/local/go/src/runtime/chan.go:388 +0x2b fp=0xc420053f50 sp=0xc420053f20 pc=0x40439b
      main.main()
        foo.go:9 +0x6f fp=0xc420053f80 sp=0xc420053f50 pc=0x4512ef
      runtime.main()
        /usr/local/go/src/runtime/proc.go:185 +0x20d fp=0xc420053fe0 sp=0xc420053f80 pc=0x424bad
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc420053fe8 sp=0xc420053fe0 pc=0x44b4d1
      
      goroutine 2 [force gc (idle)]:
      runtime.gopark(0x4739b8, 0x4ad720, 0x47001e, 0xf, 0x14, 0x1)
        /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003e768 sp=0xc42003e738 pc=0x42503c
      runtime.goparkunlock(0x4ad720, 0x47001e, 0xf, 0xc420000114, 0x1)
        /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003e7a8 sp=0xc42003e768 pc=0x42512e
      runtime.forcegchelper()
        /usr/local/go/src/runtime/proc.go:238 +0xcc fp=0xc42003e7e0 sp=0xc42003e7a8 pc=0x424e5c
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003e7e8 sp=0xc42003e7e0 pc=0x44b4d1
      created by runtime.init.4
        /usr/local/go/src/runtime/proc.go:227 +0x35
      
      goroutine 3 [GC sweep wait]:
      runtime.gopark(0x4739b8, 0x4ad7e0, 0x46fdd2, 0xd, 0x419914, 0x1)
        /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003ef60 sp=0xc42003ef30 pc=0x42503c
      runtime.goparkunlock(0x4ad7e0, 0x46fdd2, 0xd, 0x14, 0x1)
        /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003efa0 sp=0xc42003ef60 pc=0x42512e
      runtime.bgsweep(0xc42001e150)
        /usr/local/go/src/runtime/mgcsweep.go:52 +0xa3 fp=0xc42003efd8 sp=0xc42003efa0 pc=0x419973
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003efe0 sp=0xc42003efd8 pc=0x44b4d1
      created by runtime.gcenable
        /usr/local/go/src/runtime/mgc.go:216 +0x58
      one more line, no multiline

   3. Salvare il file test.log.

4. All'interno della cartella multiline-app, crea il Dockerfile.

   1. Incolla i contenuti seguenti nel file:

      FROM public.ecr.aws/amazonlinux/amazonlinux:latest
      ADD test.log /test.log
      
      RUN yum upgrade -y && yum install -y python3
      
      WORKDIR /usr/local/bin
      
      COPY main.py .
      
      CMD ["python3", "main.py"]

   2. Salvare il file Dockerfile.

5. Usando il Dockerfile, crea un'immagine.

   1. Crea l'immagine: docker build -t multiline-app-image .

      Dove: multiline-app-image è il nome dell'immagine in questo esempio.

   2. Verifica che l'immagine sia stata creata correttamente: docker images —filter reference=multiline-app-image

      In caso di esito positivo, l'output mostra l'immagine e il tag latest.

6. Carica l'immagine nel registro del container Amazon Elastic.

   1. Crea un ECR repository Amazon per archiviare l'immagine: aws ecr create-repository --repository-name multiline-app-repo --region us-east-1

      Dove: multiline-app-repo è il nome del repository e us-east-1 è la regione in questo esempio.

      L'output fornisce i dettagli del nuovo repository. Annota il valore repositoryUri poiché sarà necessario nei passaggi successivi.

   2. Applica un tag all'immagine con il valore repositoryUri ricavato dall'output precedente: docker tag multiline-app-image repositoryUri

      Esempio: docker tag multiline-app-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

   3. Esegui l'immagine Docker per verificare che sia stata eseguita correttamente: docker images —filter reference=repositoryUri

      Nell'output, il nome del repository cambia da multiline-app-repo al valore repositoryUri.

   4. Invia l'immagine ad AmazonECR: docker push aws_account_id.dkr.ecr.region.amazonaws.com/repository name

      Esempio: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

Crea la definizione di un processo e avviare il processo

1. Crea un file di definizione del processo con il nome del file multiline-task-definition.json.

2. Incolla i contenuti seguenti nel file multiline-task-definition.json:

   {
       "family": "firelens-example-multiline",
       "taskRoleArn": "task role ARN,
       "executionRoleArn": "execution role ARN",
       "containerDefinitions": [
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-image:latest",
               "name": "log_router",
               "firelensConfiguration": {
                   "type": "fluentbit",
                   "options": {
                       "config-file-type": "file",
                       "config-file-value": "/extra.conf"
                   }
               },
               "memoryReservation": 50
           },
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/multiline-app-image:latest",
               "name": "app",
               "logConfiguration": {
                   "logDriver": "awsfirelens",
                   "options": {
                       "Name": "cloudwatch_logs",
                       "region": "us-east-1",
                       "log_group_name": "multiline-test/application",
                       "auto_create_group": "true",
                       "log_stream_prefix": "multiline-"
                   }
               },
               "memoryReservation": 100
           }
       ],
       "requiresCompatibilities": ["FARGATE"],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512"
   }

   Sostituisci quanto segue nella definizione del processo multiline-task-definition.json:

   1. task role ARN

      Per trovare il ruolo dell'attivitàARN, vai alla IAM Console. Scegli Roles (Roli) e trova il ruolo del processo ecs-task-role-for-firelens che hai creato. Scegli il ruolo e copia ARNquello che appare nella sezione Riepilogo.

   2. execution role ARN

      Per trovare il ruolo di esecuzioneARN, vai alla IAM Console. Scegli Roles (Ruoli) e trova il ruolo ecsTaskExecutionRole. Scegli il ruolo e copia ARNquello che appare nella sezione Riepilogo.

   3. aws_account_id

      Per trovare l'aws_account_id, accedi alla AWS Management Console. Scegli il tuo nome utente in alto a destra e copia il tuo ID account.

   4. us-east-1

      Sostituisci la regione se necessario.

3. Registra il file di definizione del processo: aws ecs register-task-definition --cli-input-json file://multiline-task-definition.json --region us-east-1

4. Apri la console nella https://console.aws.amazon.com/ecs/versione 2.

5. Nel pannello di navigazione, scegli Task Definitions (Definizioni dei processi) quindi scegli la famiglia firelens-example-multiline, perché sopra abbiamo registrato la definizione dell'attività processo in questa famiglia nella prima riga della definizione del processo.

6. Scegli la versione più recente.

7. Scegli Distribuisci, Esegui attività.

8. Nella pagina Esegui attività, in Cluster scegli il cluster, quindi in Reti scegli le sottoreti disponibili per tale attività in Sottoreti.

9. Scegli Create (Crea) .

Verifica che i messaggi di log multilinea in Amazon CloudWatch appaiano concatenati

1. Apri la console all'indirizzo. CloudWatch https://console.aws.amazon.com/cloudwatch/

2. Nel pannello di navigazione, espandi Logs (Log) e scegli Log groups (Gruppi di log).

3. Scegli il gruppo di log multiline-test/applicatio.

4. Scegli il log e visualizza i messaggi. Le righe che corrispondono alle regole nel file parser vengono concatenate e appaiono come un singolo messaggio.

   Il seguente snippet di log mostra una traccia dello stack Go concatenata in un singolo evento:

   {
       "log": "panic: my panic\n\ngoroutine 4 [running]:\npanic(0x45cb40, 0x47ad70)\n  /usr/local/go/src/runtime/panic.go:542 +0x46c fp=0xc42003f7b8 sp=0xc42003f710 pc=0x422f7c\nmain.main.func1(0xc420024120)\n  foo.go:6 +0x39 fp=0xc42003f7d8 sp=0xc42003f7b8 pc=0x451339\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003f7e0 sp=0xc42003f7d8 pc=0x44b4d1\ncreated by main.main\n  foo.go:5 +0x58\n\ngoroutine 1 [chan receive]:\nruntime.gopark(0x4739b8, 0xc420024178, 0x46fcd7, 0xc, 0xc420028e17, 0x3)\n  /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc420053e30 sp=0xc420053e00 pc=0x42503c\nruntime.goparkunlock(0xc420024178, 0x46fcd7, 0xc, 0x1000f010040c217, 0x3)\n  /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc420053e70 sp=0xc420053e30 pc=0x42512e\nruntime.chanrecv(0xc420024120, 0x0, 0xc420053f01, 0x4512d8)\n  /usr/local/go/src/runtime/chan.go:506 +0x304 fp=0xc420053f20 sp=0xc420053e70 pc=0x4046b4\nruntime.chanrecv1(0xc420024120, 0x0)\n  /usr/local/go/src/runtime/chan.go:388 +0x2b fp=0xc420053f50 sp=0xc420053f20 pc=0x40439b\nmain.main()\n  foo.go:9 +0x6f fp=0xc420053f80 sp=0xc420053f50 pc=0x4512ef\nruntime.main()\n  /usr/local/go/src/runtime/proc.go:185 +0x20d fp=0xc420053fe0 sp=0xc420053f80 pc=0x424bad\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc420053fe8 sp=0xc420053fe0 pc=0x44b4d1\n\ngoroutine 2 [force gc (idle)]:\nruntime.gopark(0x4739b8, 0x4ad720, 0x47001e, 0xf, 0x14, 0x1)\n  /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003e768 sp=0xc42003e738 pc=0x42503c\nruntime.goparkunlock(0x4ad720, 0x47001e, 0xf, 0xc420000114, 0x1)\n  /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003e7a8 sp=0xc42003e768 pc=0x42512e\nruntime.forcegchelper()\n  /usr/local/go/src/runtime/proc.go:238 +0xcc fp=0xc42003e7e0 sp=0xc42003e7a8 pc=0x424e5c\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003e7e8 sp=0xc42003e7e0 pc=0x44b4d1\ncreated by runtime.init.4\n  /usr/local/go/src/runtime/proc.go:227 +0x35\n\ngoroutine 3 [GC sweep wait]:\nruntime.gopark(0x4739b8, 0x4ad7e0, 0x46fdd2, 0xd, 0x419914, 0x1)\n  /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003ef60 sp=0xc42003ef30 pc=0x42503c\nruntime.goparkunlock(0x4ad7e0, 0x46fdd2, 0xd, 0x14, 0x1)\n  /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003efa0 sp=0xc42003ef60 pc=0x42512e\nruntime.bgsweep(0xc42001e150)\n  /usr/local/go/src/runtime/mgcsweep.go:52 +0xa3 fp=0xc42003efd8 sp=0xc42003efa0 pc=0x419973\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003efe0 sp=0xc42003efd8 pc=0x44b4d1\ncreated by runtime.gcenable\n  /usr/local/go/src/runtime/mgc.go:216 +0x58",
       "container_id": "xxxxxx-xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:2"
   }

   Il seguente snippet di log mostra come viene visualizzato lo stesso evento se si esegue un ECS container non configurato per concatenare messaggi di log multilinea. Il campo di log contiene una singola riga.

   {
       "log": "panic: my panic",
       "container_id": "xxxxxx-xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:3"