SLA Request Payload

SNA pushes a Request metrics payload to the Sahamati endpoint every 10 minutes. This payload captures all API calls sent by the AA to each FIP, including counts and response time percentiles. The tag for this payload is req-fipMetrics-aa.

Schema Reference

Field	Type	Description
agentVersion	string	Version of the SNA agent generating this payload
jsonVersion	string	Version of the JSON schema (e.g. "1.0.0")
tag	string	"req-fipMetrics-aa" identifies this as a request-metrics payload from AA perspective of FIP
txnId	string	Unique transaction ID for this push request
fromDateTime	string	Start of the 10-minute reporting window (ISO 8601, UTC). E.g. 2023-11-08T15:30:00Z
toDateTime	string	End of the 10-minute reporting window (ISO 8601, UTC). E.g. 2023-11-08T15:40:00Z
duration	int	Duration in seconds of the reporting window (600 for 10 minutes)
aaId	string	Entity ID of the Account Aggregator
fips[].fipId	string	Entity ID of the FIP for which metrics are reported in this block
fips[].metrics[].type	string	Metric type code (e.g. adisc, alink, adlink, alinkv, cns, cnot, fireq, sfireqnot, ffireqnot, fif, hbt)
fips[].metrics[].pxx	array[int]	Response time percentiles in milliseconds: [p50, p95, p99, p100]
fips[].metrics[].counts	array[int]	Count values aligned to countFields enum in the payload
fips[].metrics[].sumOfSizeOfDataPackets	string	Sum of encrypted FI/fetch packet sizes (only for type "fif")

Metric Types (metricTypes enum)

Code	Full Name	Description
adisc	accountsDiscoverSent_adisc	Account discovery requests sent to FIP (POST /Accounts/discover)
alink	accountsLinkSent_alink	Account link requests sent (POST /Accounts/link)
adlink	accountsDelinkSent_adlink	Account delink requests sent (POST /Accounts/delink)
alinkv	accountsLinkVerifySent_alinkv	Account link verification requests sent (POST /Accounts/link/verify)
cns	consentSent_cns	Consent requests sent to FIP (POST /Consent)
cnot	consentNotificationSent_cnot	Consent notification messages sent (POST /Consent/Notification)
fireq	fiReqSent_fireq	FI requests sent (POST /FI/request)
sfireqnot	fiReq200OkToFISuccNotifTimeDiff_sfireqnot	Time difference from FI request 200 OK to success notification (at least one account READY or DELIVERED)
ffireqnot	fiReq200OkToFIFailNotifTimeDiff_ffireqnot	Time difference from FI request 200 OK to failure notification (all accounts DENIED or TIMEOUT)
fif	fiFetchSent_fif	FI fetch requests sent (POST /FI/Fetch)
hbt	heartBeatSent_hbt	Heartbeat messages sent to check FIP connectivity (GET /Heartbeat)

Count Fields (countFields enum)

The counts array in each metric entry is positionally aligned to the following fields in this exact order:

Position	Field Name	Description
1	totalSentCnt	Total number of requests sent
2	200OKRecdCnt	HTTP 200 OK responses received
3	400BadReqRecdCnt	HTTP 400 Bad Request responses received
4	401UnauthorizedReqRecdCnt	HTTP 401 Unauthorized responses received
5	403ForbiddenReqRecdCnt	HTTP 403 Forbidden responses received
6	404NotFoundRecdCnt	HTTP 404 Not Found responses received
7	409IdempotencyErrorReqRecdCnt	HTTP 409 Idempotency Error responses received
8	412Pre-ConditionFailedRecdCnt	HTTP 412 Precondition Failed responses received
9	429TooManyReqsRecdCnt	HTTP 429 Too Many Requests (rate limited) responses received
10	4xxOtherErrorsRecdCnt	All other 4xx error responses received
11	500InternalServerErrorRecdCnt	HTTP 500 Internal Server Error responses received
12	502BadGatewayRecdCnt	HTTP 502 Bad Gateway responses received
13	503ServiceUnavailableRecdCnt	HTTP 503 Service Unavailable responses received
14	504GatewayTimeoutRecdCnt	HTTP 504 Gateway Timeout responses received
15	5xxOtherErrorsRecdCnt	All other 5xx error responses received