Tyk Analytics Record Fields
Below is a detailed list of each field contained within our Tyk Analytics Record that is sent from Tyk Pump.
Method
Request method.
Example: GET
, POST
.
Host
Request Host
header.
Remarks: Includes host and optional port number of the server to which the request was sent.
Example: tyk.io
, or tyk.io:8080
if port is included.
Path
Request path.
Remarks: Displayed in decoded form.
Example: /foo/bar
for /foo%2Fbar
or /foo/bar
.
RawPath
Request path.
Remarks: Original request path without changes just decoded.
Example: /foo/bar
for /foo%2Fbar
or /foo/bar
.
ContentLength
Request Content-Length
header.
Remarks: The number of bytes in the request body.
Example: 10
for request body 0123456789
.
UserAgent
Request User-Agent
header.
Example: curl/7.86.0
.
Day
Request day.
Remarks: Based on TimeStamp
field.
Example: 16
for 2022-11-16T03:01:54Z
.
Month
Request month.
Remarks: Based on TimeStamp
field.
Example: 11
for 2022-11-16T03:01:54Z
.
Year
Request year.
Remarks: Based on TimeStamp
field.
Example: 2022
for 2022-11-16T03:01:54Z
.
Hour
Request hour.
Remarks: Based on TimeStamp
field.
Example: 3
for 2022-11-16T03:01:54Z
.
ResponseCode
Response code.
Remarks: Only contains the integer element of the response code. Can be generated by either the gateway or upstream server, depending on how the request is handled.
Example: 200
for 200 OK
.
APIKey
Request authentication key.
Remarks: OAuthentication key, as provided in request. If no API key is provided then gateway will substitute a default value.
Example: Unhashed auth_key
, hashed 6129dc1e8b64c6b4
, or 00000000
if no authentication provided.
TimeStamp
Request timestamp.
Remarks: Generated by the gateway, based on the time it receives the request from the client.
Example: 2022-11-16T03:01:54.648+00:00
.
APIVersion
Version of API Definition requested.
Remarks: Based on version configuration of context API definition. If API is unversioned then value is “Not Versioned”.
Example: Could be an alphanumeric value such as 1
or b
. Is Not Versioned
if not versioned.
APIName
Name of API Definition requested.
Example: Foo API
.
APIID
Id of API Definition requested.
Example: 727dad853a8a45f64ab981154d1ffdad
.
OrgID
Organisation Id of API Definition requested.
Example: 5e9d9544a1dcd60001d0ed20
.
OauthID
Id of OAuth client.
Remarks: Value is empty string if not using OAuth, or OAuth client not present.
Example: my-oauth-client-id
.
RequestTime
Duration of upstream roundtrip.
Remarks: Equal to value of Latency.Total
field.
Example: 3
for a 3ms roundtrip.
RawRequest
Raw HTTP request.
Remarks: Base64 encoded copy of the request sent from the gateway to the upstream server.
Example: R0VUIC9nZXQgSFRUUC8xLjEKSG9zdDogdHlrLmlv
.
RawResponse
Raw HTTP response.
Remarks: Base64 encoded copy of the response sent from the gateway to the client.
Example: SFRUUC8xLjEgMjAwIE9LCkNvbnRlbnQtTGVuZ3RoOiAxOQpEYXRlOiBXZWQsIDE2IE5vdiAyMDIyIDA2OjIxOjE2IEdNVApTZXJ2ZXI6IGd1bmljb3JuLzE5LjkuMAoKewogICJmb28iOiAiYmFyIgp9Cg==
.
IPAddress
Client IP address.
Remarks: Taken from either X-Real-IP
or X-Forwarded-For
request headers, if set. Otherwise, determined by gateway based on request.
Example: 172.18.0.1
.
Geo
Client geolocation data.
Remarks: Calculated using MaxMind database, based on client IP address.
Example: {"country":{"isocode":"SG"},"city":{"geonameid":0,"names":{}},"location":{"latitude":0,"longitude":0,"timezone":""}}
.
Network
Network statistics.
Remarks: Not currently used.
Latency
Latency statistics
Remarks: Contains two fields; upstream
is the roundtrip duration between the gateway sending the request to the upstream server and it receiving a response. total
is the upstream
value plus additional gateway-side functionality such as processing analytics data.
Example: {"total":3,"upstream":3}
.
Note
We record the round trip time of the call from the gateways reverse proxy. So what you get is the sum of leaving Tyk -> upstream -> response received back at Tyk
.
Tags
Session context tags.
Remarks: Can contain many tags which refer to many things, such as the gateway, API key, organisation, API definition etc.
Example: ["key-00000000","org-5e9d9544a1dcd60001d0ed20","api-accbdd1b89e84ec97f4f16d4e3197d5c"]
.
Alias
Session alias.
Remarks: Alias of the context authenticated identity. Blank if no alias set or request is unauthenticated.
Example: my-key-alias
.
TrackPath
Tracked endpoint flag.
Remarks: Value is true
if the requested endpoint is configured to be tracked, otherwise false
.
Example: true
or false
.
ExpireAt
Future expiry date.
Remarks: Can be used to implement automated data expiry, if supported by storage.
Example: 2022-11-23T07:26:25.762+00:00
.