Carico di lavoro Java/JMX di esempio per cluster Amazon ECS

JMX Exporter è un esportatore ufficiale di Prometheus che può recuperare ed esporre JMX mBeans JMX come metriche Prometheus. Per ulteriori informazioni, vedere prometheus/jmx_exporter.

L' CloudWatch agente con supporto Prometheus analizza i parametri Java/JMX Prometheus in base alla configurazione del service discovery nel cluster Amazon ECS. È possibile configurare JMX Exporter per esporre le metriche su una porta o metrics_path diverso. Se modifichi la porta o il percorso, aggiorna la sezione predefinita nella configurazione dell'agente. ecs_service_discovery CloudWatch

Per raccogliere parametri da un carico di lavoro Prometheus di esempio per Amazon ECS, devi eseguire Container Insights nel cluster. Per informazioni sull'installazione di Container Insights, consulta Configurazione di Container Insights su Amazon ECS.

Per installare il carico di lavoro di esempio Java/JMX per cluster Amazon ECS

1. Procedi come descritto in queste sezioni per creare le immagini Docker.

   • Esempio: immagine Docker dell'applicazione Java Jar con parametri Prometheus

   • Esempio: immagine Docker Apache Tomcat con parametri Prometheus

2. Specifica le due etichette Docker seguenti nel file di definizione dell'attività Amazon ECS. Puoi quindi eseguire la definizione dell'attività come servizio Amazon ECS o attività Amazon ECS nel cluster.

   • Imposta ECS_PROMETHEUS_EXPORTER_PORT per puntare all'elemento containerPort in cui sono esposti i parametri Prometheus.

   • Imposta Java_EMF_Metrics su true. L' CloudWatch agente utilizza questo flag per generare il formato metrico incorporato nell'evento di registro.

   Di seguito è riportato un esempio:

   {
     "family": "workload-java-ec2-bridge",
     "taskRoleArn": "{{task-role-arn}}",
     "executionRoleArn": "{{execution-role-arn}}",
     "networkMode": "bridge",
     "containerDefinitions": [
       {
         "name": "tomcat-prometheus-workload-java-ec2-bridge-dynamic-port",
         "image": "your_docker_image_tag_for_tomcat_with_prometheus_metrics",
         "portMappings": [
           {
             "hostPort": 0,
             "protocol": "tcp",
             "containerPort": 9404
           }
         ],
         "dockerLabels": {
           "ECS_PROMETHEUS_EXPORTER_PORT": "9404",
           "Java_EMF_Metrics": "true"
         }
       }
     ],
     "requiresCompatibilities": [
       "EC2"  ],
     "cpu": "256",
     "memory": "512"
     }

L'impostazione predefinita dell' CloudWatch agente nel AWS CloudFormation modello consente sia l'individuazione dei servizi basata su etichette docker sia l'individuazione dei servizi basata sulla definizione delle attività ARN. Per visualizzare queste impostazioni predefinite, vedere la riga 65 del file di configurazione YAML dell' CloudWatch agente. I container con l'etichetta ECS_PROMETHEUS_EXPORTER_PORT verranno individuati automaticamente in base alla porta del container specificata per lo scraping di Prometheus.

L'impostazione predefinita dell' CloudWatch agente contiene anche l'metric_declarationimpostazione per Java/JMX alla riga 112 dello stesso file. Tutte le etichette docker dei contenitori di destinazione verranno aggiunte come etichette aggiuntive nelle metriche di Prometheus e inviate a Logs. CloudWatch Per i container Java/JMX con etichetta Docker Java_EMF_Metrics=“true”, verrà generato il formato della metrica incorporata.