⯇ Vorheriges Tutorial

In 0 - Projekt einrichten haben wir unser JMeter-Projekt aufgesetzt und alles für unseren ersten Test vorbereitet. In diesem Tutorial zeigen wir, wie Metriken exponiert werden.

Überblick

Die aktuelle Übersicht über die Metriken finden Sie unter https://webtoolkit.jadice.com/doc/docs/en/reference/monitoring/

Micrometer

Das Tutorial 005 wurde erweitert, sodass die für das Exponieren der Metriken benötigten Dependencies vorhanden sind:

    <!-- Required for exposing the metrics (only needed for the performance test tutorial, which is not part of tutorial 005 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-aop</artifactId>
    </dependency>
    <dependency>
      <groupId>io.micrometer</groupId>
      <artifactId>micrometer-registry-prometheus</artifactId>
      <scope>runtime</scope>
    </dependency>

Außerdem wurde die application.yml angepasst, sodass die Metriken, wie im Spring-Boot Umfeld gewohnt, exponiert werden:

management:
  endpoints:
    web:
      exposure:
        include: health, metrics, info, prometheus
        # uncomment the following line for detailed cache info (created via CacheInfoResource)
        # include: health, metrics, info, prometheus, jwtcachedetailed

  metrics:
    enable:
      all: true
    export:
      prometheus:
        enabled: true

  endpoint:
    health:
      show-components: always
      show-details: always

Wenn nun das Tutorial 005 gestartet wird, können wir über 2 Links die Metriken sehen:

• http://127.0.0.1:8080/actuator/metrics (Micrometer)
  • hier sehen Sie einen Überblick über alle Metriken
  • Möchten Sie z.B. den Wert jwt.read.document betrachten, bitte folgende URL aufrufen: http://127.0.0.1:8080/actuator/metrics/jwt.read.document
• http://127.0.0.1:8080/actuator/prometheus 
  • hier sehen Sie die Prometheus Werte. Beachten Sie bitte hier vor allem, dass im Unterschied zu Micrometer ein Underscore statt eines Punkts als Trenner verwendet wird. 

Prometheus und Grafana

Eine kurze Einführung, wie man Prometheus und Grafana nutzen kann, um die Werte aus dem Lasttest (s. nächstes Kapitel) zu visualisieren, finden wir im Unterordner jwt-tutorial-performancetest\src\test\resources in der README.md