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)
- enabled (Default = true)
- initial_interval (Default = 5s)
- max_interval (Default = 1215s)
- max_elapsed_time (Default = 1820s)
- multiplier (Default = 3)
[<=]
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)
- enabled (Default = true)
- initial_interval (Default = 5s)
- max_interval (Default = 1215s)
- max_elapsed_time (Default = 1820s)
- multiplier (Default = 3)
- otel_traces_sampler (Default always_off)
- otel_traces_sampler_arg (Default 0)
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.
[<=]