← Java

Java · 24 / 24

Betrieb mit Healthchecks, Metriken und CI

Du prüfst einen Health-Endpunkt und einen Zähler für tatsächlich angenommene Aufträge.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: Spring-Boot-REST mit Validierung, Spring Security: Anmeldung und Berechtigungen

In diesem Tutorial
  1. Den Fachvertrag lesen
  2. Die Umgebung isoliert starten
  3. Erfolg und Fehler prüfen
  4. Eine Regression sichtbar machen
  5. Den Vertrag erweitern
  6. Die Lösung und ihre Grenzen erklären
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

JDK 21, Maven ab 3.9. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.

Geprüft am 20.10.2026 unter Linux x86_64. HTTP-Tests prüfen Health und den Zähler vor und nach einer Aktion. Die CI-Datei führt dieselben Tests aus. Ein lokaler Health-Status ist kein Nachweis für Alarmierung oder Wiederherstellung im Betrieb.

Ein laufender Prozess beweist noch keine erfolgreiche Fachaktion. Deshalb trennen wir technische Erreichbarkeit und einen konkreten Geschäftszähler. Ein gültiger Request erhöht accepted.jobs. Eine ungültige Eingabe erhöht ihn nicht. Der Test fragt die Metrik über HTTP ab. Diese lokale Demo bindet ausschließlich Loopback und beschreibt keine öffentliche Monitoring-Freigabe.

Paketinhalt und einzelne Dateien

01Den Fachvertrag lesen

Health beschreibt Erreichbarkeit und Bereitschaft. Metriken zählen beobachtete Vorgänge. Logs erklären einzelne Ereignisse. Diese Signale beantworten verschiedene Fragen und sollten keine privaten Nutzdaten oder unbegrenzt viele Kennwerte erzeugen.

src/main/java/tutorial/Application.java · javaDatei öffnen
package tutorial;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

  public static void main(String[] args) {
    SpringApplication.run(Application.class, args);
  }
}

@org.springframework.web.bind.annotation.RestController
class Jobs {

  private final io.micrometer.core.instrument.Counter accepted;
  private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(
    Jobs.class
  );

  Jobs(io.micrometer.core.instrument.MeterRegistry registry) {
    accepted = registry.counter("accepted.jobs");
  }

  @org.springframework.web.bind.annotation.PostMapping("/jobs")
  org.springframework.http.ResponseEntity<String> create(
    @org.springframework.web.bind.annotation.RequestBody String title
  ) {
    if (
      title.isBlank()
    ) return org.springframework.http.ResponseEntity.badRequest().body(
      "Title required"
    );
    accepted.increment();
    log.info("job accepted");
    return org.springframework.http.ResponseEntity.accepted().body("queued");
  }
}

02Die Umgebung isoliert starten

Java 21 ist die festgelegte Sprachbasis. Maven löst die Abhängigkeiten aus der POM auf. Der Test verwendet eigene Daten. HTTP-Tests starten einen Server auf einem zufällig zugewiesenen lokalen Port.

pom.xml · xmlDatei öffnen
<project xmlns="http://maven.apache.org/POM/4.0.0">
<modelVersion>4.0.0</modelVersion>
<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>4.1.0</version></parent>
<groupId>learning</groupId><artifactId>tutorial</artifactId><version>1.0</version>
<properties><java.version>21</java.version></properties>
<dependencies>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency>
</dependencies>
<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>

03Erfolg und Fehler prüfen

HTTP-Tests prüfen Health und den Zähler vor und nach einer Aktion. Die CI-Datei führt dieselben Tests aus. Ein lokaler Health-Status ist kein Nachweis für Alarmierung oder Wiederherstellung im Betrieb.

src/test/java/tutorial/LessonTest.java · javaDatei öffnen
package tutorial;

import static org.junit.jupiter.api.Assertions.*;

import java.net.*;
import java.net.http.*;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class LessonTest {

  @LocalServerPort
  int port;

  HttpResponse<String> get(String path) throws Exception {
    return HttpClient.newHttpClient().send(
      HttpRequest.newBuilder(
        URI.create("http://127.0.0.1:" + port + path)
      ).build(),
      HttpResponse.BodyHandlers.ofString()
    );
  }

  int post(String text) throws Exception {
    return HttpClient.newHttpClient()
      .send(
        HttpRequest.newBuilder(URI.create("http://127.0.0.1:" + port + "/jobs"))
          .POST(HttpRequest.BodyPublishers.ofString(text))
          .header("Content-Type", "text/plain")
          .build(),
        HttpResponse.BodyHandlers.ofString()
      )
      .statusCode();
  }

  @Test
  void healthAndBusinessMetric() throws Exception {
    assertEquals(200, get("/actuator/health").statusCode());
    assertTrue(
      get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
    );
    assertEquals(400, post(" "));
    assertTrue(
      get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
    );
    assertEquals(202, post("Example"));
    assertTrue(
      get("/actuator/metrics/accepted.jobs").body().contains("\"value\":1.0")
    );
  }
}

Starten / prüfen

mvn test
Erwartetes Ergebnis

HTTP-Tests prüfen Health und den Zähler vor und nach einer Aktion. Die CI-Datei führt dieselben Tests aus. Ein lokaler Health-Status ist kein Nachweis für Alarmierung oder Wiederherstellung im Betrieb.

04Eine Regression sichtbar machen

Verändere eine fachliche Erwartung und starte den Test erneut. Maven muss einen Fehler melden. Ein übersprungener Datenbanktest ist kein Nachweis. Stelle anschließend die richtige Erwartung wieder her.

05Den Vertrag erweitern

Prüfe, dass sensible Verwaltungsendpunkte nicht versehentlich freigegeben sind.

06Die Lösung und ihre Grenzen erklären

Die Lösung erwartet 404 für /actuator/env. Nur health und metrics werden freigegeben. Ein Produktionssystem benötigt zusätzliche Zugriffskontrolle und eine festgelegte Aufbewahrung für Logs. Nutzdaten werden hier nicht geloggt. Kopiere solution/LessonTest.java über die Testdatei und wiederhole denselben Prüfablauf.

Erwartetes Ergebnis

Alle Testfälle bestehen, einschließlich der zusätzlichen Lösungserwartung.

Deine Übung

Prüfe, dass sensible Verwaltungsendpunkte nicht versehentlich freigegeben sind.

Lösung mit Erklärung anzeigen

Die Lösung erwartet 404 für /actuator/env. Nur health und metrics werden freigegeben. Ein Produktionssystem benötigt zusätzliche Zugriffskontrolle und eine festgelegte Aufbewahrung für Logs. Nutzdaten werden hier nicht geloggt.

solution/LessonTest.java · javaDatei öffnen
package tutorial;

import static org.junit.jupiter.api.Assertions.*;

import java.net.*;
import java.net.http.*;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class LessonTest {

  @LocalServerPort
  int port;

  HttpResponse<String> get(String path) throws Exception {
    return HttpClient.newHttpClient().send(
      HttpRequest.newBuilder(
        URI.create("http://127.0.0.1:" + port + path)
      ).build(),
      HttpResponse.BodyHandlers.ofString()
    );
  }

  int post(String text) throws Exception {
    return HttpClient.newHttpClient()
      .send(
        HttpRequest.newBuilder(URI.create("http://127.0.0.1:" + port + "/jobs"))
          .POST(HttpRequest.BodyPublishers.ofString(text))
          .header("Content-Type", "text/plain")
          .build(),
        HttpResponse.BodyHandlers.ofString()
      )
      .statusCode();
  }

  @Test
  void healthAndBusinessMetric() throws Exception {
    assertEquals(404, get("/actuator/env").statusCode());
    assertEquals(200, get("/actuator/health").statusCode());
    assertTrue(
      get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
    );
    assertEquals(400, post(" "));
    assertTrue(
      get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
    );
    assertEquals(202, post("Example"));
    assertTrue(
      get("/actuator/metrics/accepted.jobs").body().contains("\"value\":1.0")
    );
  }
}

Projektbezug und Quellen

Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.