C_12753_Anlage_V1.0.0


C_12753_Anlage

Inhaltsverzeichnis

1 Änderungsbeschreibung

Die Telemetriedaten Anforderungen zur Konfiguration des Lieferverhalten sind nicht technisch korrekt wiedergegeben, weil die exemplarischen Parameter einer .NET Implementierung versprechen und hier aber eine YAML Konfiguration verwendet wird.

2 Änderung in gemSpec_Perf

Folgende Afos werden abgelöst:

alt:

A_28780 - Performance - Telemetriedatenlieferung - Batchverarbeitung RS

Das Produkt MUSS für die Telemetriedatenlieferung von Traces des Ressource Servers an den Telemetriedaten-Service des ZETA Guards als ExportProcessorType den Typ Batch verwenden (dies ist auch der Standardwert bei OpenTelemetry)
[<=]

neu:

A_28780-01 - Performance - Telemetriedatenlieferung - Batchverarbeitung RS

Das Produkt MUSS für die Telemetriedatenlieferung von Traces des Ressource Servers an den Telemetriedaten-Service des ZETA Guards den OTLP-Exporter mit eingeschaltetem Batching verwenden.
[<=]

alt:

A_28779 - Performance - Telemetriedatenlieferung - Konfiguration Datenlieferung RS

Das Produkt MUSS die Konfigurierbarkeit der Telemetriedatenlieferung des Ressource Servers an den Telemetriedaten-Service des ZETA Guards in einer ausgelagerten Konfiguration für folgende Parameter ermöglichen:

Batch - BatchExportOptions

  • maxQueueSize (Default = 2048)
  • scheduledDelayMilliseconds (Default = 5000)
  • exporterTimeoutMilliseconds (Default = 30000)
  • maxExportBatchSize (Default = 512)
ExporterHelper - retry_on_failure
  • enabled (Default = true)
  • initial_interval (Default = 5s)
  • max_interval (Default = 1215s)
  • max_elapsed_time (Default = 1820s)
  • multiplier (Default = 3)
Hinweis: Die dargestellte Parametrisierung orientiert sich an den OTEL-Standards und kann für die Konfiguration eines OTEL-Collectors am RS genutzt werden. Sofern für die Datensammlung am RS kein OTEL-Collector zum Einsatz kommt, ist die Konfiguration der Datenübermittlung vom RS an den Telemetriedaten-Service des ZETA-Guards im Sinne dieser Konfigurationsparameter zu ermöglichen.
[<=]

neu:

A_28779-01 - Performance - Telemetriedatenlieferung - Konfiguration Datenlieferung RS

Das Produkt MUSS die Konfigurierbarkeit der Telemetriedatenlieferung des ZETA Guards an die gematik Telemetriedatencloud in einer ausgelagerten Konfiguration unterstützen.

Beispielhaft sind hier wichtige Parameter der YAML Konfiguration inkl. Default-Werten gelistet:

processors:
 batch:
   send_batch_size: 512
   timeout: 5s
exporters:
 otlp:
   timeout: 30s
   sending_queue:
     enabled: true
     queue_size: 2048
   retry_on_failure:
     enabled: true
     initial_interval: 5s
     max_interval: 1215s
     max_elapsed_time: 1820s

Hinweis: Die dargestellte Parametrisierung orientiert sich an den OTEL-Standards und kann für die YAML Konfiguration eines OTEL-Collectors am RS genutzt werden. Sofern für die Datensammlung am RS kein OTEL-Collector zum Einsatz kommt, ist die Konfiguration der Datenübermittlung vom RS an den Telemetriedaten-Service des ZETA-Guards im Sinne dieser Konfigurationsparameter zu ermöglichen.
[<=]

alt:

A_28782 - Performance - Telemetriedatenlieferung - Konfiguration Datenlieferung ZETA Guard

Das Produkt MUSS die Konfigurierbarkeit der Telemetriedatenlieferung des ZETA Guards an die gematik Telemetriedatencloud in einer ausgelagerten Konfiguration für folgende Parameter unterstützen:

Batch - BatchExportOptions

  • maxQueueSize (Default = 2048)
  • scheduledDelayMilliseconds (Default = 5000)
  • exporterTimeoutMilliseconds (Default = 30000)
  • maxExportBatchSize (Default = 512)
ExporterHelper - retry_on_failure
  • enabled (Default = true)
  • initial_interval (Default = 5s)
  • max_interval (Default = 1215s)
  • max_elapsed_time (Default = 1820s)
  • multiplier (Default = 3)
Sampler
  • otel_traces_sampler (Default always_off)
  • otel_traces_sampler_arg (Default 0)
Hinweis: Sampler Typ wird auf traceidratio gesetzt, um Sampling einzuschalten und die Ratio kann variabel einen Wert zwischen 0..1 einnehmen. Der Typ garantiert, dass der Sampling Trace vollständig ist und alle Spans für eine Auswahl enthalten sind. [<=]

neu:

A_28782-01 - Performance - Telemetriedatenlieferung - Konfiguration Datenlieferung ZETA Guard

Das Produkt MUSS die Konfigurierbarkeit der Telemetriedatenlieferung des ZETA Guards an die gematik Telemetriedatencloud in einer ausgelagerten Konfiguration unterstützen.

Beispielhaft sind hier wichtige Parameter der YAML Konfiguration inkl. Default-Werten gelistet:

processors:
 batch:
   send_batch_size: 512
   timeout: 5s
exporters:
 otlp:
   timeout: 30s
   sending_queue:
     enabled: true
     queue_size: 2048
   retry_on_failure:
     enabled: true
     initial_interval: 5s
     max_interval: 1215s
     max_elapsed_time: 1820s

[<=]

Folgende Afo wird zusätzlich ergänzt:

A_28988 - Performance - Telemetriedatenlieferung - Konfiguration Datenlieferung ZETA Guard - Sampling

Wenn für die Telemetriedatenlieferung des Produktes an die gematik Telemetriedatencloud die Option Sampling aktiviert wurde, MÜSSEN nachfolgende, konfigurierbare Parameter berücksichtigt werden:

tail_sampling:
   decision_wait: 10s
   num_traces: 50000
   expected_new_traces_per_sec: 200
   policies:
     - name: errors-always
       type: status_code
       status_code:
         status_codes: [ERROR]
     - name: success-sampled
       type: probabilistic
       probabilistic:
         sampling_percentage: 5

Hinweis: Sampling SOLL im Standard deaktiviert sein und kann über die oben genannten Parameter aktiviert werden. Durch die Policy "error-always" wird sichergestellt, dass Fehlermeldungen immer gesendet werden. [<=]

Prüfverfahren: funkt. Eignung - Herstellererklärung

Produkte: PoPP_Service, VSDM_2_FD, DiPAG_FD, Herst_FdV_ZT

Prüfverfahren: funkt. Eignung - Test Produkt/FA

Produkte: ZT_Cluster

3 Änderung in gemSpec_ZETA

Folgende Afo wird abgelöst:

alt:

A_27727-01 - ZETA Guard, Telemetriedaten-Service, Lieferung

Der Telemetriedaten-Service im ZETA Guard SOLL Telemetriedaten asynchron an den gematik Telemetriedaten-Service liefern. Dafür MUSS der Telemetriedaten-Service des ZETA Guard für die Telemetriedatenlieferung von Traces an den gematik Telemetriedaten-Service als ExportProcessorType den Typ Batch verwenden (dies ist auch der Standardwert bei OpenTelemetry).
[<=]

neu:

A_27727-02 - ZETA Guard, Telemetriedaten-Service, Lieferung

Der Telemetriedaten-Service im ZETA Guard SOLL Telemetriedaten asynchron an den gematik Telemetriedaten-Service liefern. Dafür MUSS der Telemetriedaten-Service des ZETA Guard für die Telemetriedatenlieferung von Traces an den gematik Telemetriedaten-Service den OTLP-Exporter mit eingeschaltetem Batching verwenden.
[<=]