Citrix ADC 12.1 NITRO API Reference

gslbsite

Statistics for GSLB site resource.

Properties

(click to see Operations)

Name Data Type Permissions Description
sitename Read-write Name of the GSLB site for which to display detailed statistics. If a name is not specified, basic information about all GSLB sites is displayed.
Minimum length = 1
clearstats Read-write Clear the statsistics / counters.
Possible values = basic, full
sitepublicip Read-only The public IP address of this GSLB site.
siteip Read-only The private IP address of this GSLB site.
sitemepstatus Read-only Indicates the status of the Metric Exchange Policy at this GSLB site.
persexchange Read-only Indicates whether Persistence entries exchange is enabled or disabled at this GSLB site.
nwmetricexchange Read-only Indicates whether network metric exchange is enabled or disabled at this GSLB site.
sitemetricexchange Read-only Indicates whether metric exchange is enabled or disabled at this GSLB site.
sitetype Read-only Indicates whether this GSLB site is local or remote.
siteipstr Read-only The private IP address of this GSLB site.
sitepublicipstr Read-only The public IP address of this GSLB site.
sitemetricmepstatus Read-only Indicates the status of the site metric Metric Exchange connection at this GSLB site.
nwmetricmepstatus Read-only Indicates the status of the network metric Metric Exchange connection at this GSLB site.
sitetotalrequestbytes Read-only Total number of request bytes received by the virtual servers represented by all GSLB services associated with this GSLB site.
siterequestbytesrate Read-only Rate (/s) counter for sitetotalrequestbytes
sitetotalresponsebytes Read-only Number of response bytes received by the virtual servers represented by all GSLB services associated with this GSLB site.
siteresponsebytesrate Read-only Rate (/s) counter for sitetotalresponsebytes
sitetotalrequests Read-only Total number of requests received by the virtual servers represented by all GSLB services associated with this GSLB site.
siterequestsrate Read-only Rate (/s) counter for sitetotalrequests
sitetotalresponses Read-only Number of responses received by the virtual servers represented by all GSLB services associated with this GSLB site.
siteresponsesrate Read-only Rate (/s) counter for sitetotalresponses
sitecurclntconnections Read-only Number of current client connections to the virtual servers represented by all GSLB services associated with this GSLB site.
sitecursrvrconnections Read-only Number of current connections to the real servers behind the virtual servers represented by all GSLB services associated with this GSLB site.

Operations

(click to see Properties)

GET (ALL) GET

Some options that you can use for each operations:

  • Getting warnings in response:NITRO allows you to get warnings in an operation by specifying the "warning" query parameter as "yes". For example, to get warnings while connecting to the Citrix ADC appliance, the URL is as follows:

    http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/login?warning=yes

    If any, the warnings are displayed in the response payload with the HTTP code "209 X-NITRO-WARNING".

  • Authenticated access for individual NITRO operations:NITRO allows you to logon to the Citrix ADC appliance to perform individual operations. You can use this option instead of creating a NITRO session (using the login object) and then using that session to perform all operations,

    To do this, you must specify the username and password in the request header of the NITRO request as follows:

    X-NITRO-USER:<username>

    X-NITRO-PASS:<password>

    Note:In such cases, make sure that the request header DOES not include the following:

    Cookie:NITRO_AUTH_TOKEN=<tokenvalue>

*Note:*

Mandatory parameters are marked in redand placeholder content is marked in <green>.

get (all)

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/stat/gslbsite

Query-parameters:

args

http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/stat/gslbsite?args=sitename:<String_value>,detail:<Boolean_value>,fullvalues:<Boolean_value>,ntimes:<Double_value>,logfile:<String_value>,clearstats:<String_value>

Use this query-parameter to get gslbsite resources based on additional properties.

HTTP Method:GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue> Accept:application/json

Response:

HTTP Status Code on Success: 200 OK HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for Citrix ADC specific errors). The response payload provides details of the errorResponse Headers:

Content-Type:application/json

Response Payload:


{ "gslbsite": [ {
"sitename":<String_value>,
"siteresponsesrate":<Double_value>,
"siteipstr":<String_value>,
"sitetotalrequests":<Double_value>,
"siterequestsrate":<Double_value>,
"nwmetricmepstatus":<String_value>,
"sitemetricexchange":<String_value>,
"sitepublicip":<String_value>,
"sitetotalresponsebytes":<Double_value>,
"sitecursrvrconnections":<Double_value>,
"sitepublicipstr":<String_value>,
"sitetotalrequestbytes":<Double_value>,
"siteip":<String_value>,
"sitemepstatus":<String_value>,
"sitecurclntconnections":<Double_value>,
"sitetype":<String_value>,
"nwmetricexchange":<String_value>,
"persexchange":<String_value>,
"siterequestbytesrate":<Double_value>,
"siteresponsebytesrate":<Double_value>,
"sitetotalresponses":<Double_value>,
"sitemetricmepstatus":<String_value>
}]}

<!--NeedCopy-->

get

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/stat/gslbsite/sitename_value><String>

HTTP Method:GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue> Accept:application/json

Response:

HTTP Status Code on Success: 200 OK HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for Citrix ADC specific errors). The response payload provides details of the errorResponse Headers:

Content-Type:application/json

Response Payload:


{ "gslbsite": [ {
"sitename":<String_value>,
"siteresponsesrate":<Double_value>,
"siteipstr":<String_value>,
"sitetotalrequests":<Double_value>,
"siterequestsrate":<Double_value>,
"nwmetricmepstatus":<String_value>,
"sitemetricexchange":<String_value>,
"sitepublicip":<String_value>,
"sitetotalresponsebytes":<Double_value>,
"sitecursrvrconnections":<Double_value>,
"sitepublicipstr":<String_value>,
"sitetotalrequestbytes":<Double_value>,
"siteip":<String_value>,
"sitemepstatus":<String_value>,
"sitecurclntconnections":<Double_value>,
"sitetype":<String_value>,
"nwmetricexchange":<String_value>,
"persexchange":<String_value>,
"siterequestbytesrate":<Double_value>,
"siteresponsebytesrate":<Double_value>,
"sitetotalresponses":<Double_value>,
"sitemetricmepstatus":<String_value>
}]}

<!--NeedCopy-->
gslbsite