The following shows how to generate the load-balancing-dns-traffic-errors-by-property report using either the Reporting API's Generate a report POST operation or the Get a cacheable report GET operation. Details about each report's supported products, metrics, filters, and available data intervals are also available dynamically by running the API's Get a report type operation, also shown below. See also other available reports.

Report definition

Errors Details for a Domain by property.

Business object: fpdomain

Data available for: 90 days

Available metrics

Metric	Description
Data metrics
`agentIp`	String representation of an IPv4 or IPv6 address of the Akamai test agent.
`answeringIp`	String representation of an IPv4 or IPv6 address of the customer server.
`datacenter`	DataCenter name.
`domain`	Domain name.
`duration`	The number of seconds the error occurred for.
`errorDescription`	The description of the Error.
`errorTime`	The time the error occurred.
`property`	Property name.
`testName`	Liveness Test name.

POST request

POST /reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4/report-data{?start,end}

Sample: /reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4/report-data?start=2023-04-01T00%3A00%3A00Z&end=2023-05-01T00%3A00%3A00Z

Query parameters

Parameter	Type	Sample	Description
Required
`start`	String	`2023-04-01T00:00:00Z`	Specifies the start of the reported period as an ISO-8601 timestamp with optional time zone. The report includes data that matches the `start` value’s timestamp.
`end`	String	`2023-05-01T00:00:00Z`	Specifies the end of the reported period as an ISO-8601 timestamp with optional time zone. The report excludes any data that matches the `end` value’s timestamp.

JSON request members

Member	Type	Description
`objectIds`	Array	Specifies the single `fpdomain` value you want to report on.
`metrics`	Array	The set of desired metrics. If omitted, the report includes all available metrics.

Request body:

{
    "objectIds": [
        "www.example.com"
    ],
    "metrics": [
        "agentIp",
        "answeringIp",
        "datacenter",
        "domain",
        "duration",
        "errorDescription",
        "errorTime",
        "property",
        "testName"
    ]
}

GET request

GET /reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4/report-data{?start,end,objectIds,metrics}

Sample: /reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4/report-data?start=2023-04-01T00%3A00%3A00Z&end=2023-05-01T00%3A00%3A00Z&objectIds=www.example.com&metrics=agentIp%2CansweringIp

Query parameters

Parameter	Type	Sample	Description
Required
`start`	String	`2023-04-01T00:00:00Z`	Specifies the start of the reported period as an ISO-8601 timestamp with optional time zone. The report includes data that matches the `start` value’s timestamp.
`end`	String	`2023-05-01T00:00:00Z`	Specifies the end of the reported period as an ISO-8601 timestamp with optional time zone. The report excludes any data that matches the `end` value’s timestamp.
Optional
`objectIds`	String	`www.example.com`	Specifies the unique ID for the single `fpdomain` objectType you want to report on.
`metrics`	String	`agentIp,answeringIp`	Specifies a comma-separated list of metrics to include in the report, otherwise all metrics if omitted. The set of available metrics depends on the type of report. URL-encode the entire value in the GET request.

JSON response

Status 200 application/json

Response body:

{
    "metadata": {
        "name": "load-balancing-dns-traffic-errors-by-property",
        "version": "4",
        "outputType": "FLAT",
        "groupBy": [
            "startdatetime"
        ],
        "start": "2023-04-01T00:00:00Z",
        "end": "2023-05-01T00:00:00Z",
        "availableDataEnds": null,
        "suggestedRetryTime": null,
        "rowCount": 4,
        "filters": [],
        "columns": [
            {
                "name": "groupBy",
                "label": "startdatetime"
            },
            {
                "name": "agentIp",
                "label": "Server Monitor Ip"
            },
            {
                "name": "answeringIp",
                "label": "Answering Ip"
            },
            {
                "name": "datacenter",
                "label": "DataCenter"
            },
            {
                "name": "domain",
                "label": "Domain"
            },
            {
                "name": "duration",
                "label": "Duration"
            },
            {
                "name": "errorDescription",
                "label": "Error Description"
            },
            {
                "name": "errorTime",
                "label": "Error Time"
            },
            {
                "name": "property",
                "label": "Property"
            },
            {
                "name": "testName",
                "label": "Test Name"
            }
        ],
        "objectType": "fpdomain",
        "objectIds": [
            "www.example.com"
        ]
    },
    "data": [
        {
            "startdatetime": "2019-05-01T00:00:30Z",
            "agentIp": "111.111.1.1",
            "answeringIp": "250.250.250.250",
            "datacenter": "Datacenter_1",
            "domain": "example.com",
            "duration": 5,
            "errorDescription": "Bad Request",
            "errorTime": "2019-06-01T00:00:00Z",
            "property": "Property_1",
            "testName": "name0"
        },
        {
            "startdatetime": "2019-05-01T00:00:05Z",
            "agentIp": "111.111.1.1",
            "answeringIp": "250.250.250.251",
            "datacenter": "Datacenter_5",
            "domain": "testdomain.com",
            "duration": 12,
            "errorDescription": "Not Found",
            "errorTime": "2019-06-01T00:00:10Z",
            "property": "Property_12",
            "testName": "name1"
        },
        {
            "startdatetime": "2019-05-01T00:00:20Z",
            "agentIp": "Other",
            "answeringIp": "Other",
            "datacenter": "Other",
            "domain": "Other",
            "duration": "Other",
            "errorDescription": "Other",
            "errorTime": "Other",
            "property": "Other",
            "testName": "Other"
        },
        {
            "startdatetime": "2019-05-01T00:00:10Z",
            "agentIp": "111.111.1.1",
            "answeringIp": "250.250.250.253",
            "datacenter": "Datacenter_11",
            "domain": "testdomain123.com",
            "duration": 20,
            "errorDescription": "Forbidden",
            "errorTime": "2019-06-01T00:00:15Z",
            "property": "Property_35",
            "testName": "name2"
        }
    ],
    "summaryStatistics": {}
}

CSV response

Status 200 text/csv

Response Body:

#METADATA_START
name,load-balancing-dns-traffic-errors-by-property
version,4
source,load-balancing-dns-traffic-errors-by-property/versions/4
groupBy,startdatetime
start,2023-04-01T00:00:00Z
end,2023-05-01T00:00:00Z
availableDataEnds,
suggestedRetryTime,
rowCount,4
objectType,fpdomain
objectIds,www.example.com
#METADATA_END

#SUMMARYSTATISTICS_START

#SUMMARYSTATISTICS_END

#COLUMNS_START
startdatetime,agentIp,answeringIp,datacenter,domain,duration,errorDescription,errorTime,property,testName
#COLUMNS_END

#DATA_START
2019-05-01T00:00:30Z,111.111.1.1,250.250.250.250,Datacenter_1,example.com,5,Bad Request,2019-06-01T00:00:00Z,Property_1,name0
2019-05-01T00:00:05Z,111.111.1.1,250.250.250.251,Datacenter_5,testdomain.com,12,Not Found,2019-06-01T00:00:10Z,Property_12,name1
2019-05-01T00:00:20Z,Other,Other,Other,Other,Other,Other,Other,Other,Other
2019-05-01T00:00:10Z,111.111.1.1,250.250.250.253,Datacenter_11,testdomain123.com,20,Forbidden,2019-06-01T00:00:15Z,Property_35,name2
#DATA_END

Get report details

This sample Get a report type operation gets the same information you need to run the load-balancing-dns-traffic-errors-by-property report as provided in this reference documentation, but available dynamically to your API client application.

GET /reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4

Status 200 application/json

Response body:

{
    "name": "load-balancing-dns-traffic-errors-by-property",
    "description": "Errors Details for a Domain by property.",
    "businessObjectName": "fpdomain",
    "version": 4,
    "status": "PUBLISHED",
    "deprecated": false,
    "timeBased": false,
    "supportsPagination": false,
    "outputType": "FLAT",
    "available": true,
    "metrics": [
        {
            "name": "property",
            "description": "Property name.",
            "label": "Property",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "domain",
            "description": "Domain name.",
            "label": "Domain",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "testName",
            "description": "Liveness Test name.",
            "label": "Test Name",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "datacenter",
            "description": "DataCenter name.",
            "label": "DataCenter",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "agentIp",
            "label": "Server Monitor Ip",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "answeringIp",
            "description": "String representation of an IPv4 or IPv6 address of the customer server.",
            "label": "Answering Ip",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "errorDescription",
            "description": "The description of the Error.",
            "label": "Error Description",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "duration",
            "description": "The number of seconds the error occurred for.",
            "label": "Duration",
            "unit": "STRING",
            "summaryStatistic": false
        },
        {
            "name": "errorTime",
            "description": "The time the error occurred.",
            "label": "Error Time",
            "unit": "STRING",
            "summaryStatistic": false
        }
    ],
    "groupOutlyingValues": {
        "enabled": false
    },
    "groupBy": [
        "startdatetime"
    ],
    "intervals": [
        "HOUR",
        "DAY",
        "FIVE_MINUTES"
    ],
    "dataRetentionDays": 90,
    "links": [
        {
            "rel": "self",
            "href": "/reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4"
        },
        {
            "rel": "versions",
            "href": "/reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions"
        },
        {
            "rel": "all-reports",
            "href": "/reporting-api/v1/reports"
        },
        {
            "rel": "execute-report",
            "href": "/reporting-api/v1/reports/load-balancing-dns-traffic-errors-by-property/versions/4/report-data"
        }
    ]
}