SSLO¶
Overview¶
Module Name in API¶
bigip-sslo
Product Name in API¶
local-traffic
Dimensions¶
Dimension | Name in API | Description |
---|---|---|
Virtual Server | virtual | |
BIG-IP Blade Number | slot-id | Used for BIG-IP Chassis with multiple blades. A value of 0 means this is a non chassis BIG-IP, any other value tells the serial number of the blade in the chassis |
IP Reputation | ip-reputation | The reputation of the client IP |
Topology | topology | SSLO Topology Name |
Serving Application IP | serving-application-ip | |
Serving Application | serving-application-name | |
Serving Application Family | serving-application-family | |
Service Path | service-path | |
Client Cipher Name | client-cipher-name | |
BIG-IP Host Name | hostname | The hostname given to the BIG-IP |
URL Category | url-category | |
Application Service | applicationService | |
Server Cipher Version | server-cipher-version | |
Decryption Status | decryption-status | |
Destination Country | destination-country | |
BIG-IP Service Cluster | dsc-name | Clusters of BIG-IPs grouped together to have the same config |
Server Cipher Name | server-cipher-name | |
Client Cipher Version | client-cipher-version | |
Traffic Type | traffic-type | |
Application | applications | |
Action | security-action | The action a security module took with this transaction/packet, such as allow or block |
MetricSets¶
Bytes Out To Client¶
Description¶
Name In API¶
client-bytes-out
Metrics in the metricSet¶
Metric | Name in API | Unit | Description |
---|---|---|---|
Total Bytes Out To Client | sum | bytes | Total number of bytes that were transmitted to client |
Avg Bytes Out To Client | avg-value-per-sec | Bps | Average number of bytes that were transmitted to client |
Connection Duration¶
Description¶
Duration of TCP connections from the moment they are established until they are closed, this value is rough estimation and should not be treated as exact duration
Name In API¶
connections-duration
Metrics in the metricSet¶
Metric | Name in API | Unit | Description |
---|---|---|---|
Connections Duration | avg-value-per-event | ms | Average duration of TCP connections from the moment they are established until they are closed, this value is rough estimation and should not be treated as exact duration |
Bytes In From Client¶
Description¶
Name In API¶
client-bytes-in
Metrics in the metricSet¶
Metric | Name in API | Unit | Description |
---|---|---|---|
Total Bytes In From Client | sum | bytes | Total number of bytes that were received from client |
Avg Bytes In From Client | avg-value-per-sec | Bps | Average number of bytes that were received from client |
Client Side New Connections¶
Description¶
Name In API¶
client-connections
Metrics in the metricSet¶
Metric | Name in API | Unit | Description |
---|---|---|---|
Total Client Side New Connections | sum | conns | Total number of new connections opened at client side |
Avg Client Side New Connections | avg-value-per-sec | conns/s | Average rate of new connections opened at client side |
Bytes Out To Server¶
Description¶
Name In API¶
server-bytes-out
Metrics in the metricSet¶
Metric | Name in API | Unit | Description |
---|---|---|---|
Total Bytes Out To Server | sum | bytes | Total number of bytes that were transmitted to server |
Avg Bytes Out To Server | avg-value-per-sec | Bps | Average number of bytes that were transmitted to server |
Bytes In From Server¶
Description¶
Name In API¶
server-bytes-in
Metrics in the metricSet¶
Metric | Name in API | Unit | Description |
---|---|---|---|
Total Bytes In From Server | sum | bytes | Total number of bytes that were received from server |
Avg Bytes In From Server | avg-value-per-sec | Bps | Average number of bytes that were received from server |
Examples¶
By Time Query¶
A query by time returns a series of data points in time, based on optional filters, time range, and time granularity. This query kind is identified by the keyword: “ap:query:stats:byTime”
POST https://<address>/mgmt/ap/query/v1/tenants/default/products/local-traffic/metric-query
This example for JSON body in the post, filters by dimension virtual and get the sum of client-bytes-out
{
"kind": "ap:query:stats:byTime",
"module": "bigip-sslo",
"timeRange": {
"from": "-1h",
"to": "now"
},
"timeGranularity": {
"duration": 30,
"unit": "SECONDS"
},
"aggregations": {
"client-bytes-out$sum": {
"metricSet": "client-bytes-out",
"metric": "sum"
}
},
"dimensionFilter": {
"type": "eq",
"dimension": "virtual",
"value": "value to filter by"
}
}
By Entities Query¶
A query by entities returns a sort set of entities, based on optional filters, time range, and choosen metric to sort by. This query kind is identified by the keyword: “ap:query:stats:byEntities”
POST https://<address>/mgmt/ap/query/v1/tenants/default/products/local-traffic/metric-query
This example for JSON body in the post, gets top entities of type virtual, sorted by sum of client-bytes-out
{
"kind": "ap:query:stats:byEntities",
"module": "bigip-sslo",
"timeRange": {
"from": "-1H",
"to": "now"
},
"dimension": "virtual",
"sortMetric": "client-bytes-out$sum",
"sortOrder": "desc",
"aggregations": {
"client-bytes-out$sum": {
"metricSet": "client-bytes-out",
"metric": "sum"
}
},
"limit": 5
}
Entities Count Query¶
An entities count query returns the distinct count of entities, based on optional filters, time range, and choosen entity type. This query kind is identified by the keyword: “ap:query:stats:entitiesCount”
POST https://<address>/mgmt/ap/query/v1/tenants/default/products/local-traffic/metric-query
This example for JSON body in the post, gets the distinct count of entities of type virtual
{
"kind": "ap:query:stats:entitiesCount",
"module": "bigip-sslo",
"dimension": "virtual",
"timeRange": {
"from": "-1h",
"to": "now"
}
}