Ihre Meinung macht den Unterschied
Jetzt Feedback zum gematik Fachportal geben!

Unterstützen Sie uns dabei, das gematik Fachportal weiter zu verbessern.
Was funktioniert gut? Wo sehen Sie Optimierungsbedarf? Nehmen Sie sich einen Moment Zeit und bringen Sie Ihre Perspektive ein.

Hier geht es zur Umfrage

C_12662_Anlage_V1.0.0


C_12662_Anlage

Inhaltsverzeichnis

1 Änderungsbeschreibung

Vorabinformation zum Änderungseintrag:
Folgende Änderungen sind Bestandteil des Änderungseintrages:

Die Nummerierung der Kapitel entspricht nicht der Nummerierung aus den referenzierenden Dokumenten, da diese durch die Formatierung automatisch erzeugt wird. Dies wird bei der Einarbeitung der Änderungen entsprechend beachtet.

Erläuterung:
hier nur normativ notwendige Texte
in Begleitdokument der dynamische Teil
beide zusammen beschreiben den aktuellen Stand des Prozesses


Hinweise zur Lesart:
<<Text, der zur Erklärung der Änderung dient - wird nicht mit eingearbeitet/übernommen.>>
Text, der neu ist.
Text, der entfernt wird.
Text, der entfernt wird.


entfällt: Inhalte sind in A_26532-01 berücksichtigt

A_27473 - Performance - PoPP-Service - Messung von Bearbeitungszeiten

Der PoPP-Service MUSS alle Zeiten zu einem Request/Response-Paar aufzeichnen und verarbeiten. Unterzeiträume werden gleichzeitig gesondert gemessen und verarbeitet.

Rahmenbedingungen:
Die Zeit (in ms) vom vollständigen Eingang eines Requests an der Außenschnittstelle bis hin zum Start des Versands einer Antwortnachricht (Response) an derselben ist die Gesamtbearbeitungszeit. Die Gesamtbearbeitungszeit unterteilt sich ggf. in Unterzeiträume, die gesondert gemessen und ausgewertet werden (z.B. gemäß A_27477* und A_27030*).

Die vom PoPP-Service zu verantwortende Bearbeitungszeit umfasst alle Zeiten, die der PoPP-Service zur Bearbeitung des Requests selbstständig aufwendet. Die vom PoPP-Service zu verantwortende Bearbeitungszeit erfasst NICHT die Zeiten, die den Abruf an Drittsysteme (z.B. an OCSP) betreffen. [<=]

entfällt:

A_26178 - Performance - Selbstauskunft - Umsetzungszeit zur Änderung des Lieferintervalls

Der Anbieter MUSS die Änderung der Konfiguration vom Lieferintervall (gemäß [A_26177*]) nach Aufforderung durch die gematik innerhalb von 5 Werktagen (ausgenommen bundeseinheitliche Feiertage) vornehmen. [<=]

entfällt:

TIP1-A_6437 - Datenaufbewahrung von Performancedaten

Anbieter (ausgenommen ist TSP CVC eGK) MÜSSEN die Performancedaten 6 Monate aufbewahren.

[<=]

Zuordnung entfällt:

A_26175 - Performance - Selbstauskunft - Verpflichtung des Anbieters

Der Anbieter MUSS die Erfassung, Aufbereitung und Übermittlung der Daten zur Selbstauskunft gewährleisten. [<=]

1.1 Änderungen in gemSpec_Perf

Neue ( Anforderungszuordnungen):

Im Zuge der neuen FQDN Festlegungen (private Domain) des PoPP-Dienstes ist eine Registrierung der 4 AuthServer in der TI-Föderation (in den 3 Umgebungen RU/TU/PU) verbunden und damit eine Zuordnung aller Anforderungen für die Föderationsmitgliedschaft folgerichtig.
konkret:

A_23042 - Verifikation der Certificate Transparency für TLS Verbindungen in die VAU

Die Hersteller der Fachdienste MÜSSEN prüfen ob die CA, welche die TLS Zertifikate für Verbindungen in den sicheren Verarbeitungskontext eines sektoralen Identity Provider erstellt hat, Certificate Transparency gemäß RFC 6962/RFC 9162 unterstützt. [<=]

A_23349 - Performance - Servicezeiten des Produktes - Hauptzeit - Montag bis Sonntag

Das Produkt MUSS folgende Servicezeiten gewährleisten: 

  • Hauptzeit ist Montag bis Sonntag von 6 bis 22 Uhr
  • Bundeseinheitliche Feiertage und alle übrigen Stunden der Woche sind Nebenzeit.
[<=]

entfällt, da workload Identity verwendet wird

A_27719 - Telemetriedatenlieferung - Nutzung eines gültigen Client-Zertifikats

Der Anbieter MUSS für den Verbindungsaufbau zum Telemetriedaten-Service der gematik ein gültiges TLS Client-Zertifikat nutzen.
Hinweis: Ein entsprechendes TLS Client-Zertifikat muss vor Inbetriebnahme bei der gematik beantragt werden. [<=]

A_27718 bleibt

A_27796 bleibt

Korrektur des Satzes aus dem Kap 2.5.4 https://gemspec.gematik.de/docs/gemSpec/gemSpec_Perf/latest/#2.5.4 :

"Die gesammelten Telemetriedaten werden auf Basis des OpenTelemetry Protokolls (OTLP) über gRPC gesendet und von der gematik empfangen. Die gematik prüft den Sender auf ein gültiges Client-Zertifikat und erlaubt nur validierte Zugriffe über mTLS."

neu (zugeordnet PoPP): 

A_28890 - Verbindungsaufbau zum Telemetriedaten-Service

Der Anbieter MUSS für den Verbindungsaufbau zum Telemetriedaten-Service der gematik einen OAuth 2.0 Token Exchange (gem. RFC 8693) unterstützen.

Hinweis:
Die Basis für die Authentifizierung muss im Rahmen der Inbetriebnahme bei der gematik durchgeführt werden.  [<=]

A_28891 - Verbindungsaufbau zum Telemetriedaten-Service des Produkts

Das Produkt MUSS für den Verbindungsaufbau zum Telemetriedaten-Service der gematik einen OAuth 2.0 Token Exchange (gem. RFC 8693) unterstützen.

Hinweis:
Die Basis für die Authentifizierung muss im Rahmen der Inbetriebnahme bei der gematik durchgeführt werden. [<=]

neue (konkretisierte) Anforderung:

A_28866 - Auswahl der Domain für TLS-terminierte Vertrauenswürdige Ausführungsumgebungen (VAU)

Der Anbieter, der eine TLS-Terminierte VAU betreibt, MUSS diese Endpunkte unter einer eigenständigen Domain betreiben, die für nichts anderes als Endpunkte dieser VAU verwendet wird.

Hinweis:
Um Überschneidungen der Namensräume von Zertifikaten zu vermeiden, also dass zum Beispiel ein *.firma.tld Zertifikat auch den vep1.firma.tld (oder ein *.sub1.fima.tld auch vep1.sub1.firma.tld) VAU Endpunkt umfasst, wird die Verwendung einer eigenständigen Second-Level Domain vorgeschrieben, die für nichts anderes als VAU Endpunkte des selben Betreibers verwendet werden darf.
Ist eine VAU über mehrere Endpunkten zu erreichen, so sind diese jeweils als alternative Namen (Subject Alternative Name) im Zertifikat aufzuführen.
Die Nutzung von Wildcard-Zertifikaten ist nicht zulässig. [<=]

neue (konkretisierte) Anforderung:

A_28886 - Verbot von wildcard-Namenseinträgen für TLS-terminierte VAU Endpunkte

Zertifikate für TLS-Terminierte VAU Endpunkte DÜRFEN NICHT Wildcard-Namesseinträge beinhalten. [<=]

alt: (bleibt)

A_23006 - Subdomäne für Webservice-Endpunkte in der VAU

Der Verarbeitungskontext des sektoralen IDP MUSS diese Endpunkte anbieten:

  • Endpunkt für Authorization Requests
  • Endpunkt für Pushed Authorization Requests
  • Token-Endpunkt
Für die Endpunkte der VAU MUSS eine eigene Subdomäne, welche keine Wildcard-Domäne ist, erstellt werden. [<=]

1.2 Änderungen in gemSpec_Perf


Einfügen hinter "3.28 3.28 Digitale Patientenrechnung Fachdienst"

(konkrete Kapitel-Nummerierung erfolgt bei Einarbeitung --> 3.29)

1.3 (3.29) PoPP-Dienst (PDT71) Fachdienst

1.3.1 Leistungsanforderungen - Spezifika PoPP-Dienst

bleibt:

A_26332 - Performance - PoPP-Service - Verfügbarkeit

Der Anbieter PoPP-Service MUSS folgende Verfügbarkeit in den festgelegten Servicezeiten einhalten:

  • Hauptzeit: 99,99%
  • Nebenzeit: 99,97%
[<=]

bleibt:

A_26335 - Performance - PoPP-Service - Skalierung

Der Anbieter PoPP-Service MUSS die Skalierbarkeit des angebotenen Dienstes im laufenden Betrieb jederzeit gewährleisten und der gematik nachvollziehbar darstellen. Dazu dokumentiert er das eingesetzte Skalierungskonzept im Betriebshandbuch.

Hinweis: Im Zuge des Zulassungsverfahrens hat der Anbieter PoPP-Service der gematik gegenüber nachvollziehbar darzustellen, welche technischen Skalierungsmaßnahmen anhand messbarer Parameter er für den Produktivbetrieb plant durchzuführen. Die Skalierungsmaßnahmen können dabei unterschiedliche Ausprägungen und Dimensionen umfassen. Beispielsweise eine automatisierte Ressourcenzuteilung oder eine Anpassung oder Änderung unterschiedlicher technischer Komponenten, die zu einer Produktänderung im Sinne der [gemSpec_OM] führt. Die Darstellung muss Verifikationsbeschreibungen enthalten, mit denen der Erfolg der Maßnahmen ermittelt werden kann.
[<=]

bleibt:

A_26336 - Performance - PoPP-Service - Robustheit gegenüber Lastspitzen

Der PoPP-Service MUSS auch bei Lastspitzen oberhalb der definierten Spitzenlasten gemäß der Tabelle "Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben" verfügbar bleiben.
[<=]

dahinter:

Änderung
Änderung gemSpec_Perf:  Kapitel 3.29 PoPP-Service (PDT71)

Table # Tab_gemSpec_Perf_PoPP_Service: Performancerelevante UseCases

UseCase Fachdienstoperation Beschreibung
PoPP.ZT1 GET /.well-known ZETA: Abruf gültiger Autorisierungsserver
PoPP.ZT2 GET /nonce ZETA: Nonce abrufen
PoPP.ZT3 POST /token <JWT Client Assert> ZETA: Autorisierung ohne Refresh Token
PoPP.ZT4 POST /token <Refresh Token> ZETA: Autorisierung mit Refresh Token
PoPP.1 POST /httpLoadPractitionerInformationRequest Anweisung zur Suche der Daten zu einer LEI 
PoPP.2 I_PoPP_EHC_CertHash_Import Import-Schnittstelle für Zertifikats-Hashes (TSP)
PoPP.2 POST /httpCheckInGIDRequest Anweisung zur Erstellung eines PoPP-Token nach Authentifizierung des Versicherten über seine GesundheitsID
PoPP.3 POST /httpReadEgkRequest Anweisung zur Prüfung einer eGK
PoPP.4 POST /httpReadStatusPoPPRequest Anweisung für den Abruf des aktuellen Status zur PoPP-Token Erstellung

alt:

A_27030 - Performance - PoPP-Service - Bearbeitungszeit unter Last

Der PoPP-Service MUSS die Bearbeitungszeitvorgaben unter Last aus Tabelle "Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben" erfüllen.

Tabelle 1: Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben

Operation Spitzenlast
[1/sec]
Mittlere Bearbeitungszeit
[msec]
Maximale Bearbeitungszeit
[msec]
Erfüllungsquote
[%]
PoPP.1 1400 600 1500 99,99
PoPP.2 - - - -
[<=]

alt:

A_27030-01 - Performance - PoPP-Service - Bearbeitungszeit unter Last

Der PoPP-Service MUSS die Bearbeitungszeitvorgaben unter Last aus Tabelle "Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben" erfüllen.

Tabelle 2 Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben

Operation Spitzenlast
[1/sec]
Mittlere Bearbeitungszeit
[msec]
Maximale Bearbeitungszeit
[msec]
Erfüllungsquote
[%]
PoPP.UC_01 1400 600 1500 99,99
PoPP.UC_02 - - - -
PoPP.UC_03 1400 1800 (600+1200 PoPP.UC_05) 3500 99,99
PoPP.UC_04 350 1700 (500+1200 PoPP.UC_05) 3250 99,99
PoPP.UC_05 350 1200 2000 99,99
PoPP.UC_06 1400 600 1500 99,99
PoPP.UC_07 1400 600 1500 99,99
[<=]

neu:

A_27030-02 - Performance - PoPP-Service - Bearbeitungszeit unter Last

Der PoPP-Service MUSS die Bearbeitungszeitvorgaben unter Last aus Tabelle "Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben" erfüllen.


Tabelle 3 Tab_gemSpec_Perf_PoPP_Service: Last- und Bearbeitungszeitvorgaben

Operation Spitzenlast
[1/sec]
Mittlere Bearbeitungszeit
[msec]
Maximale Bearbeitungszeit
[msec]
Erfüllungsquote
[%]
PoPP.1 1400 600 1500 99,99
PoPP.2 1400 1400 1800 99,99
PoPP.3 1400 800 1200 99,99
PoPP.4 2000 200 350 99,99
[<=]

1.3.2 Telemetriedaten - Spezifika PoPP-Dienst

1.3.2.1 Telemetriedaten - Spezifika PoPP-Dienst - Traces

Neue AFO zur Duration  

A_28839 - Performance - Telemetriedaten - Spezifika PoPP-Service - Duration

Der Anbieter PoPP-Service MUSS bei Telemetriedatenlieferung im Trace Span zugehörig zum Resource Server bzgl. des Feldes "rs_duration" die ermittelte Verarbeitungszeit im Ressource Server übertragen. [<=]

entfällt: Inhalte sind in A_26532-01 berücksichtigt

A_27477 - Performance - PoPP-Service - Bearbeitungszeiten für Unterzeiträume

Der PoPP-Service MUSS zu folgenden Zeiträumen eigene Unterzeiträume selbstständig erfassen, verarbeiten und im Rahmen des Monitorings weiterleiten.

  • Backend-Duration: Zeit in ms für Anfragen an TI-Komponenten und Systeme außerhalb des PoPP-Service, z.B. OCSP.
  • Resource Server-Duration: Zeit in ms bei jedem Aufruf des Resource Server ab Erhalt des Requests vom ZeTA-Guard bis zum vollständigen Versand der Antwort an den ZeTA-Guard.
  • cardCheckTime: Zeit in ms bei jedem Aufruf mit Validierung einer eGK ab Start der APDU-Kommandos bis zum Abschluss der Bearbeitung der APDU-Kommandos.
[<=]

entfällt: Inhalte sind in A_26532-01 berücksichtigt

A_27477-01 - Performance - PoPP-Service - Bearbeitungszeiten für Unterzeiträume

Der PoPP-Service MUSS folgende Zeiträume selbstständig erfassen und bei Telemetriedatenlieferungen als key / value Paar im Trace mitliefern.

{"key": "pdt_backend_duration", "value": { "intValue": 420002020929}}

Folgende spezifischen Festlegungen hinsichtlich der Attribute und der Inhalte sind zu berücksichtigen. 
    • key "pdt_backend_duration":
      • Zeit in ms für Anfragen an TI-Komponenten und Systeme außerhalb des PoPP-Service, z.B. OCSP
      • Datentyp Integer
    • key "pdt_checkcard_duration":
      • Zeit in ms bei jedem Aufruf mit Validierung einer eGK ab Start der APDU-Kommandos bis zum Abschluss der Bearbeitung der APDU-Kommandos.
      • Datentyp Integer
[<=]

1.3.3 Telemetriedaten PoPP-Dienst Logs

Zu den Telemetriedaten Logs (ehemals Selbstauskunft) gibt es keine produktspezifischen (PoPP-Dienst) Ausprägungen und daher gelten nur die übergreifenden generischen Anteile abschließend.
neue (hinzugekommene) Anforderungszuordnung zu PoPP

A_27729-01 - Performance - Telemetriedatenlieferung - Selbstauskunft

Der Produkttyp MUSS die in der Tabelle "Tab_gemSpec_Perf_Telemetriedaten_product_info" gelisteten Parameter des Open Telemetry Logs "product_info" befüllen und die Produktinformation bei jeder Änderung an den Telemetriedaten-Service überliefern.

Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP) an den Telemetriedaten-Service der gematik.
[<=]

1.3.4 Telemetriedaten - Spezifika PoPP-Dienst - Metriken PoPP-vital und PoPP-blockedItems

Telemetriedaten - Spezifika PoPP-Dienst - Metrik PoPP-vital  (ehemals Bestandsdaten)

neue (hinzugekommene) Anforderungszuordnung zu PoPP

A_28785 - Performance - Telemetriedatenlieferung - Bestandsdaten

Der Produkttyp MUSS die in der Tabelle "Tab_gemSpec_Perf_Telemetriedaten_metric" gelisteten Parameter unter Berücksichtigung der produktspezifischen Vorgaben als eine Open Telemetry Metrik befüllen und im festgelegten, konfigurierbaren Zeitintervall an den Telemetriedaten-Service überliefern.

Das Default Zeitintervall ist täglich, beginnend mit 00:00:00.

Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP) an den Telemetriedaten-Service der gematik. [<=]

neue Anforderung

A_28835 - Telemetriedaten - Spezifika PoPP-Service - Metrik PoPP-vital

Der PoPP-Service MUSS bei den Telemetriedaten (gem. Tab_gemSpec_Perf_Telemetriedaten_metric) unter "metrics" eine Metrik mit folgenden Informationen liefern:

"name": "popp_stock_number",
"description": "numbers of various popp counter",
"unit": "1",
"type": "GAUGE",
"data_points": [...]

und unter "data_points" Datenpunkte für folgende Labels:

"status": "egkHashImport" <-Anzahl der am Berichtstag durch TSPs importierten Hashwert-Paare in die eGK-Hash-Datenbank
"status": "dailyContactTokenSucc" <-- Anzahl der am Berichtstag erfolgreich ausgestellten PoPP-Token bei kontaktbehafteter Nutzung einer eGK
"status": "dailyContactTokenFail" <-- Anzahl der am Berichtstag abgebrochenen Anfragen bei kontaktbehafteter Nutzung einer eGK
"status": "dailyContactlessTokenSucc" <-- Anzahl der am Berichtstag erfolgreich ausgestellten PoPP-Token bei kontaktloser Nutzung einer eGK
"status": "dailyContactlessTokenFail" <-- Anzahl der am Berichtstag abgebrochenen Anfragen bei kontaktloser Nutzung einer eGK
"status": "egkBlocked" <-- Anzahl der gesperrten eGK
[<=]

neue Anforderung

A_28860 - Telemetriedaten - Spezifika PoPP-Service - Metrik PoPP-blockedItems

Der PoPP-Service MUSS bei den Telemetriedaten (gem. Tab_gemSpec_Perf_Telemetriedaten_metric) unter "metrics" eine Metrik mit folgenden Informationen liefern:

"name": "popp_blocked_items",
"description": "details of blocked egk",
"unit": "1",
"type": "GAUGE",
"data_points": [...]

und unter "data_points" Datenpunkte für folgende Labels:

"number_of_elements": "Integer Anzahl der gemeldeten Einträge"
"list_of_elements": "String Base64 codierte JSON Struktur"
[<=]

entfällt:

A_27319 - Performance - Bestandsdaten - Spezifika PoPP-Service - Format

Der Anbieter PoPP-Service MUSS jeweils zum Wechsel in den nächsten Berichtsintervall, folgende Informationen im JSON-Format als HTTP Body an die Betriebsdatenerfassung gemäß [A_23110*] liefern.


"timestamp": "<Zeitstempel der Abfrage gemäß ISO 8601 unter expliziter Angabe der Zeitzone UTC im konkreten Format: YYYY-MM-DDTHH:mm:ss[.fff]Z, als String>",
"ci": "<CI-ID der abgefragten Produktinstanz gemäß [A_17764], als String>",
"egkhashcount": <Anzahl der gespeicherten Hashwerte in der eGK-Hash-Datenbank gemäß [A_27046], als Integer>
} [<=]

entfällt

A_27319-01 - Performance - Bestandsdaten - Spezifika PoPP-Service - Format

Der Anbieter PoPP-Service MUSS jeweils zum Wechsel in den nächsten Berichtsintervall, folgende Informationen im JSON-Format als HTTP Body an die Betriebsdatenerfassung gemäß [A_23110*] liefern.


"timestamp": "<Zeitstempel der Abfrage gemäß ISO 8601 unter expliziter Angabe der Zeitzone UTC im konkreten Format: YYYY-MM-DDTHH:mm:ss[.fff]Z, als String>",
"ci": "<CI-ID der abgefragten Produktinstanz gemäß [A_17764], als String>",
"egkhashcount": <Anzahl der gespeicherten Hashwerte in der eGK-Hash-Datenbank gemäß [A_27046], als Integer>
}

[<=]

alt:

A_28190 - Performance - PoPP-Service - Bearbeitungszeiten für Operation PoPP.5

Der PoPP-Service MUSS unabhängig vom Füllstand der eGK-Hash-Datenbank, aber unter Berücksichtigung der in A_27046 vorgegebenen Maximalbefüllung der eGK-Hash-Datenbank in der Lage sein, die import-Funktion in weniger als einer Minute oder mit einer Geschwindigkeit von mindestens fünftausend Einträgen pro Sekunde zu verarbeiten.

Hinweis: Der Passus "weniger als eine Minute" ist relevant, wenn die signierte Nachricht nur wenige Einträge enthält. Der Passus "mindestens fünftausend Einträge pro Sekunde" ist relevant, wenn die signierte Nachricht sehr viele Einträge enthält. Wegen des Overheads der Signaturprüfung ist eine hohe Geschwindigkeit für signierte Nachrichten mit wenigen Einträgen nicht realistisch. Der Overhead der Signaturprüfung fällt für viele Einträge in einer signierten Nachricht nicht ins Gewicht. [<=]

neu:

A_28190-01 - Performance - PoPP-Service - Import Hash-DB

Der PoPP-Service MUSS unabhängig vom Füllstand der eGK-Hash-Datenbank, aber unter Berücksichtigung der in A_27046 vorgegebenen Maximalbefüllung der eGK-Hash-Datenbank in der Lage sein, die import-Funktion in weniger als einer Minute oder mit einer Geschwindigkeit von mindestens fünftausend Einträgen pro Sekunde zu verarbeiten.

Hinweis: Der Passus "weniger als eine Minute" ist relevant, wenn die signierte Nachricht nur wenige Einträge enthält. Der Passus "mindestens fünftausend Einträge pro Sekunde" ist relevant, wenn die signierte Nachricht sehr viele Einträge enthält. Wegen des Overheads der Signaturprüfung ist eine hohe Geschwindigkeit für signierte Nachrichten mit wenigen Einträgen nicht realistisch. Der Overhead der Signaturprüfung fällt für viele Einträge in einer signierten Nachricht nicht ins Gewicht.

[<=]

alt::

A_27316 - Performance - Telemetriedatenlieferung - Spezifika PoPP-Service - Status

Der PoPP-Service MUSS bei Telemetriedatenlieferung im Trace Span zugehörig zum Resource Server bzgl. des Feldes "status" vorrangig den Fehlercode aus der Spalte "Errorcode" gemäß [A_27317] verwenden. In allen anderen Fällen ist der gültige, an den Client zurückgemeldete, HTTP-Response Code in das Feld einzutragen. [<=]

neu:

A_27316-01 - Performance - Telemetriedatenlieferung - Spezifika PoPP-Service - Status

Der PoPP-Service MUSS bei Telemetriedatenlieferung im Trace Span zugehörig zum Resource Server bzgl. des Feldes "rs_statuscode" vorrangig den Fehlercode aus der Spalte "BDE-Code" gemäß [A_27317] verwenden. In allen anderen Fällen ist der gültige, an den Client zurückgemeldete, HTTP-Response Code in das Feld einzutragen. [<=]

alt::

A_26333 - Performance - Telemetriedatenlieferung - Spezifika PoPP-Service - Operation

Der PoPP-Service MUSS bei Telemetriedatenlieferungen bzgl. des Feldes "operation" die Angabe der Spalte "UseCase" aus Tabelle [Tab_gemSpec_Perf_PoPP_Service: Performancerelevante UseCases] nutzen.

[<=]

neu:

A_26333-01 - Performance - Telemetriedatenlieferung - Spezifika PoPP-Service - Operation

Der PoPP-Service MUSS bei Telemetriedatenlieferungen den Use Case eindeutig über die Trace Parameter attributes:http_method und attributes:http_route kenntlich machen. Zu berücksichtigen sind die Operationen der Tabelle [Tab_gemSpec_Perf_PoPP_Service: Performancerelevante UseCases].

[<=]

alt::

A_26532 - Performance - Telemetriedatenlieferung - Spezifika PoPP-Service - Message

Der PoPP-Service MUSS bei Telemetriedatenlieferungen bzgl. des Feldes "message_keys" folgende spezifischen Festlegungen hinsichtlich des Formates und der Inhalte berücksichtigen.

{ "cid": "$clientid", "cv": "$clientversion", "size": $size, "rsdur": $resourceServerDuration, "cct": $cardCheckTime, "ikn": $iknummer, "pmth": "$proofmethod", "telidP": "$pn_telematikID" }

  • $clientid: <product_id> gemäß Token Self-Assessment des Clientsystems, Datentyp String
  • $clientversion: <product_version> gemäß Token Self-Assessment des Clientsystems, Datentyp String
  • $size: Größe des Requests in kilobyte, Datentyp Integer
  • $resourceServerDuration: Zeit in ms für die Bearbeitungszeit im Resource-Server, Datentyp Integer 
  • $cardCheckTime: Zeit in ms für die Echtheitsprüfung der eGK mittels APDU-Kommandos gem. [Kapitel 6.2.1 "eGK Handling"#gemSpec_PoPP_Service], Datentyp Integer
  • $iknummer: Wert von insurerId des PoPP-Token gem. [A_26431*], Datentyp Integer
  • $proofmethod: Wert von proofMethod aus dem PoPP-Token gem. [A_26431*], Datentyp String
  • $telidP: Telematik-ID des angemeldeten Nutzers, verschlüsselt gemäß [A_28578*], Datentyp String.
Bei der Erstellung des Feldes "message_keys" ist darauf zu achten, dass weder Whitespaces noch Newlines zwischen JSON-Elementen enthalten sind (kein Indenting) und Vorgaben nach [RFC7493] eingehalten werden.
[<=]

neu: 

A_26532-01 - Performance - Telemetriedatenlieferung - Spezifika PoPP-Service - Message

Der PoPP-Service MUSS bei Telemetriedatenlieferungen produkttypspezifische Informationen als key / value Paar im Trace mitliefern. 


{"key": "pdt_size", "value": { "intValue": $$$}}
{"key": "pdt_ikn", "value": { "intValue": $$$}}
{"key": "pdt_proofmethod", "value": { "stringValue": "Text"}}
{"key": "pdt_telidP", "value": { "stringValue": "Text"}}
{"key": "pdt_cardCheckTime", "value": { "intValue": $$$}}
{"key": "pdt_backend_duration", "value": { "intValue": $$$}}
{"key": "pdt_directory_search_duration", "value": { "intValue": $$$}}

Folgende spezifischen Festlegungen hinsichtlich der Attribute und der Inhalte sind zu berücksichtigen. 
  • key "pdt_size":
    • Größe des Requests in Kilobyte
    • Datentyp Integer
  • key "pdt_ikn"
    • Wert von insurerId des PoPP-Token gem. [A_26431*]
    • Datentyp Integer
  • key "pdt_proofmethod
    • Wert von proofMethod aus dem PoPP-Token gem. [A_26431*] 
    • Datentyp String
  • key "pdt_telidP"
    • Telematik-ID des angemeldeten Nutzers, verschlüsselt gemäß [A_28578*]
    • Datentyp String
  • key "pdt_cardCheckTime"
    • Zeit in ms für die Echtheitsprüfung der eGK mittels APDU-Kommandos gem. [Kapitel 6.2.1 "eGK Handling"#gemSpec_PoPP_Service]
    • Datentyp Integer
  • key "pdt_backend_duration":
    • Zeit in ms für Anfragen an TI-Komponenten und Systeme außerhalb des PoPP-Service, z.B. OCSP
    • Datentyp Integer
  • key "pdt_directory_search_duration":
    • Zeit in ms für Suche in Verzeichnissen und Systemen außerhalb des PoPP-Service, z.B. Verzeichnisdienst FHIR
    • Datentyp Integer
    [<=]

    entfällt:

    A_27320 - Performance - Bestandsdaten - Spezifika PoPP-Service

    Der Anbieter PoPP-Service MUSS in einem definierten, konfigurierbaren Zeitintervall folgende Informationen berichten:

    • Anzahl der vorhandenen eGK Hashes in der eGK-Hash-Datenbank, gemäß [A_27046].
    (Das Default Zeitintervall ist täglich, beginnend mit 00:00:00). [<=]

    neue Anforderung

    A_28889 - Performance - Telemetriedaten - Spezifika PoPP-Service - RS Duration

    Der PoPP-Service MUSS bei Telemetriedatenlieferung im Trace Span zugehörig zum Resource Server die Bearbeitungszeit im Felde "rs_duration" übermitteln.
    [<=]

    neue Anforderung

    A_28786 - Performance - Telemetriedatenlieferung - Ausnahme der Vollständigkeit

    Sofern aufgrund einer nicht vollständig durchgeführten Operation die Werte für die Parameter aus den produktspezifischen Vorgaben nicht vorliegen, KANN der Produkttyp bei der Telemetriedatenlieferung auf die Übermittlung des Key-Value-Paares verzichten. [<=]

    neue Anforderung

    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)
    [<=]

    neue Anforderung

    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.
    [<=]

    neue Anforderung

    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.
    [<=]

    neue Anforderung

    A_28766 - Performance - Telemetriedatenlieferung - Konfiguration

    Der Anbieter MUSS die Konfiguration der Parameter zur Telemetriedatenlieferung nach Aufforderung der gematik innerhalb von maximal 24h umsetzen. Dies gilt sowohl für die Telemetriedatenlieferung zwischen Ressource Server und dem Telemetriedaten-Service des ZETA Guards, als auch für die Telemetriedatenlieferung des ZETA Guards an die gematik Telemetriedatencloud. [<=]

    (Anb_DiPag_FD, Anb_VSDM_2_FD, Anb_PoPP_Service - organ./betriebl. Eignung: Anbietererklärung)

    Hinweis: Der ZETA Guard stellt ebenfalls eine Konfigurationsmöglichkeit über eine ausgelagerte Konfiguration bereit.

    neue Anforderung

    A_28754 - Wiederherstellung Datenlieferung im Störungsfall

    Der Anbieter MUSS zur Kompensation von Störungsfällen eine Wiederherstellungsstrategie mit OpenTelemetry Standardmechanismen implementieren, die sicherstellt, dass angefallene Telemetriedaten nachgeliefert werden können (z.B. ausreichend Speicherplatz, ausreichend Bandbreite - nicht abschließend).

    Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP) an den Telemetriedaten-Service der gematik.
    [<=]


    alt: A_27722-01, 02, 03 entfällt, neu: A_27722-04

    alt:

    A_27722-01 - Performance - Telemetriedatenlieferung - Status Code des Ressource Servers

    Der Produkttyp MUSS im Parameter rs.status entweder einen HTTP-Statuscode des Ressource Servers gemäß Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes oder gemäß produkttypspezifischer Definition an den Telemetriedaten-Service  übermitteln.

    Tabelle 4: Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes

    HTTP-Statuscodes
    Name der Statuscodegruppe Beschreibung
    1xx INFORMATIONAL Der Server hat die Anfrage erhalten und befindet sich in der Bearbeitung.
    2xx
    SUCCESSFUL
    Die Operation wurde erfolgreich durchgeführt.
    3xx REDIRECTION Der Client muss zusätzliche Maßnahmen ergreifen, um die Anfrage abzuschließen.
    4xx
    CLIENT_ERROR
    Ein Client-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.
    5xx
    SERVER_ERROR
    Ein Server-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.

    Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP) an den Telemetriedaten-Service der gematik. [<=]

    alt:

    A_27722-02 - Performance - Telemetriedatenlieferung - Status Code des Ressource Servers

    Der Produkttyp MUSS im Parameter rs.status entweder einen HTTP-Statuscode des Ressource Servers gemäß Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes oder gemäß produkttypspezifischer Definition an den Telemetriedaten-Service  übermitteln.

    Tabelle 5: Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes

    HTTP-Statuscodes
    Name der Statuscodegruppe Beschreibung
    Bewertung
    1xx INFORMATIONAL Der Server hat die Anfrage erhalten und befindet sich in der Bearbeitung. OTHER
    2xx
    SUCCESSFUL
    Die Operation wurde erfolgreich durchgeführt.
    SUCCESS
    3xx REDIRECTION Der Client muss zusätzliche Maßnahmen ergreifen, um die Anfrage abzuschließen. OTHER
    4xx
    CLIENT_ERROR
    Ein Client-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.
    FAILED_OTHER
    5xx
    SERVER_ERROR
    Ein Server-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.
    FAILED_SERVICE
    Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP)an den Telemetriedaten-Service der gematik.
    [<=]

    alt:

    A_27722-03 - Performance - Telemetriedatenlieferung - Status Code des Ressource Servers

    Der Produkttyp MUSS im Parameter rs_statuscode entweder einen HTTP-Statuscode des Ressource Servers gemäß Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes oder gemäß produkttypspezifischer Definition an den Telemetriedaten-Service  übermitteln.

    Tabelle 6: Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes

    HTTP-Statuscodes
    Name der Statuscodegruppe Beschreibung
    1xx INFORMATIONAL Der Server hat die Anfrage erhalten und befindet sich in der Bearbeitung.
    2xx
    SUCCESSFUL
    Die Operation wurde erfolgreich durchgeführt.
    3xx REDIRECTION Der Client muss zusätzliche Maßnahmen ergreifen, um die Anfrage abzuschließen.
    4xx
    CLIENT_ERROR
    Ein Client-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.
    5xx
    SERVER_ERROR
    Ein Server-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.

    Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP) an den Telemetriedaten-Service der gematik. [<=]

    Hinweis: Es sind vom Anbieter, anstatt der Status Code Klassen (first digit of status code), die konkreten 3-stelligen HTTP-Statuscodes gemäß [RFC9110] zu verwenden.

    neu:

    A_27722-04 - Performance - Telemetriedatenlieferung - Status Code des Ressource Servers

    Der Produkttyp MUSS im Parameter rs_statuscode entweder einen HTTP-Statuscode des Ressource Servers gemäß Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes oder gemäß produkttypspezifischer Definition an den Telemetriedaten-Service  übermitteln.

    Tabelle 7: Tab_gemSpec_Perf_Telemetriedaten_RS_Statuscodes

    HTTP-Statuscodes
    Name der Statuscodegruppe Beschreibung
    Bewertung
    1xx INFORMATIONAL Der Server hat die Anfrage erhalten und befindet sich in der Bearbeitung. OTHER
    2xx
    SUCCESSFUL
    Die Operation wurde erfolgreich durchgeführt.
    SUCCESS
    3xx REDIRECTION Der Client muss zusätzliche Maßnahmen ergreifen, um die Anfrage abzuschließen. OTHER
    4xx
    CLIENT_ERROR
    Ein Client-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.
    FAILED_OTHER
    5xx
    SERVER_ERROR
    Ein Server-seitiger Fehler verhindert die erfolgreiche Durchführung der Operation.
    FAILED_SERVICE

    Hinweis: Ist der ZETA Guard Teil des Produkttyps (z.B. VSDM2) gilt die Nachweispflicht für die Sendung an den Telemetriedaten-Service des ZETA Guards, in anderen Fällen (z.B. sektoraler IDP) an den Telemetriedaten-Service der gematik. [<=]

    2 Änderung in gemKPT_Betr

    wird überarbeitet:

    Schnittstellen::Operation bzw. Anwendungsfall

    Tabelle 8: Tab_gemKPT_Betr_PoPP-Service::O/A

    Produkttyp/
    Anwendungstyp
    S/A-ID
    Schnittstellen::Operation/
    Anwendungsfall
    Beschreibung Berichtsformat-Alias
    PDT71 S01 I* Generische Schnittstelle
    PDT71 I_PoPP_EHC_CertHash_Import Import-Schnittstelle für Zertifikats-Hashes (TSP) PoPP.2
    PDT71 S03 GET /nonce ZETA: Nonce abrufen PoPP.ZT2
    PDT71 S04 POST /token <JWT Client Assert> ZETA: Autorisierung ohne Refresh Token PoPP.ZT3
    PDT71 S05 POST /token <Refresh Token> ZETA: Autorisierung mit Refresh Token PoPP.ZT4
    PDT71 S06 POST /httpLoadPractitionerInformationRequest PoPP: Anweisung zur Suche der Daten zu einer LEI PoPP.1
    PDT71 S07 POST /httpCheckInGIDRequest PoPP: Anweisung zur Erstellung eines PoPP-Token nach Authentifizierung des Versicherten über seine GesundheitsID PoPP.2
    PDT71 S08 POST /httpReadEgkRequest PoPP: Anweisung zur Prüfung einer eGK PoPP.3
    PDT71 S09 POST /httpReadStatusPoPPRequest PoPP: Anweisung für den Abruf des aktuellen Status zur PoPP-Token Erstellung PoPP.4

    wird überarbeitet

    Performance-Kenngrößen/SL-Werte

    Der Bearbeitungszeitraum  für die aufgeführten Soll-Werte beträgt ein Kalendermonat.

    Die Bildung der Performance-Kenngrößen basiert auf folgenden PG-Schemata: PG-Schema-I

    Tab_gemKPT_Betr_PoPP-Service_Performance-Kenngroessen

    Performance-
    Kenngröße (PKG-ID)
    Beschreibung
    berechnet aus
    SL-Wert
    (Soll-Wert)
    min/max
    Normative Referenz
    PoPP-Service - PDT71 - (I*)
    PDT71-S01-D3-G33  Relative Verfügbarkeit im Betrachtungszeitraum zur Hauptzeit inkl. Wartung [%*1000]  Probing 99990
    (PU)
    min A_26332
    PDT71-S01-D3-G33  Relative Verfügbarkeit im Betrachtungszeitraum zur Hauptzeit inkl. Wartung [%*1000]  Probing 99000
    (RU/TU)
    min -
    PDT71-S01-D3-G34 Relative Verfügbarkeit im Betrachtungszeitraum zur Nebenzeit inkl. Wartung [%*1000]  Probing 99970
    (PU)
    min A_26332
    PDT71-S01-D3-G34 Relative Verfügbarkeit im Betrachtungszeitraum zur Nebenzeit inkl. Wartung [%*1000]   Probing 85000
    (RU/TU)
    min -
    PoPP-Service - POPP.2 (I_PoPP_EHC_CertHash_Import) - PDT71
    PDT71-S03-D2-G08 Mittlere Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie  650 max A_27030 
    PDT71-S03-D2-G30 Maximale Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie  1000 max A_27030 
    PDT71-S03-D2-G31 Anteil Bearbeitungen innerhalb der Bearbeitungszeitvorgabe im Betrachtungszeitraum [%*1000] Telemetrie  99990 min A_27030 
    PoPP-Service - POPP.ZT1 - PDT71
    PoPP-Service - POPP.ZT2 - PDT71
    PoPP-Service - POPP.ZT3 - PDT71
    PoPP-Service - POPP.ZT4 - PDT71
    PoPP-Service - POPP.1 - PDT71
    PDT71-S06-D2-G08 Mittlere Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie 600 max A_27030 
    PDT71-S06-D2-G30 Maximale Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie  1500 max A_27030 
    PDT71-S06-D2-G31 Anteil Bearbeitungen innerhalb der Bearbeitungszeitvorgabe im Betrachtungszeitraum [%*1000] Telemetrie  99990 min A_27030 
    PoPP-Service - POPP.2 - PDT71
    PDT71-S07-D2-G08 Mittlere Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie 1400 max A_27030 
    PDT71-S07-D2-G30 Maximale Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie  1800 max A_27030 
    PDT71-S07-D2-G31 Anteil Bearbeitungen innerhalb der Bearbeitungszeitvorgabe im Betrachtungszeitraum [%*1000] Telemetrie  99990 min A_27030 
    PoPP-Service - POPP.3 - PDT71
    PDT71-S08-D2-G08 Mittlere Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie 800 max A_27030 
    PDT71-S08-D2-G30 Maximale Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie  1200 max A_27030 
    PDT71-S08-D2-G31 Anteil Bearbeitungen innerhalb der Bearbeitungszeitvorgabe im Betrachtungszeitraum [%*1000] Telemetrie  99990 min A_27030 
    PoPP-Service - POPP.4 - PDT71
    PDT71-S09-D2-G08 Mittlere Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie 200 max A_27030 
    PDT71-S09-D2-G30 Maximale Bearbeitungszeit im Betrachtungszeitraum [msec] Telemetrie  350 max A_27030 
    PDT71-S09-D2-G31 Anteil Bearbeitungen innerhalb der Bearbeitungszeitvorgabe im Betrachtungszeitraum [%*1000] Telemetrie  99990 min A_27030