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.
C_12662_Anlage_V1.0.0
Prereleases:
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
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.
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:
"data_points": [...]
und unter "data_points" Datenpunkte für folgende Labels:
"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:
"data_points": [...]
und unter "data_points" Datenpunkte für folgende Labels:
"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.
[<=]
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_ikn", "value": { "intValue": $$$}}
{"key": "pdt_proofmethod", "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].
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)
- enabled (Default = true)
- initial_interval (Default = 5s)
- max_interval (Default = 1215s)
- max_elapsed_time (Default = 1820s)
- multiplier (Default = 3)
[<=]
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)
- 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)
[<=]
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 |
[<=]
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 |