Page created: 6 Nov 2019
|
Page updated: 25 Mar 2020
The monitor provider exposes the following information for each resource:
- Number of successful operations per request type (such as GET, PUT, and POST).
- Number of failed operations and their error codes per request type.
- Number of operations with XML or JSON from client.
- Number of operations that sent XML or JSON to client.
In addition to the information about the user-defined resources, monitoring information is also generated for the schema, service provider configuration, and monitor resources. The attributes of the monitor entry are formatted as follows:
{resource name}-resource-{request type}-{successful or error status code}
You can search for one of these monitor providers using an ldapsearch such as the following:
$ bin/ldapsearch --port 1389 bindDN uid=admin,dc=example,dc=com \ --bindPassword password --baseDN cn=monitor \ --searchScope sub "(objectclass=scim-servlet-monitor-entry)"
For example, the following monitor output was produced by a test environment with three distinct SCIM servlet instances, Aleph, Beth, and Gimel. Note that the first instance has a custom resource type called host.
$ bin/ldapsearch --baseDN cn=monitor \ '(objectClass=scim-servlet-monitor-entry)' dn: cn=SCIM Servlet (SCIM HTTP Connection Handler),cn=monitor objectClass: top objectClass: ds-monitor-entry objectClass: scim-servlet-monitor-entry objectClass: extensibleObject cn: SCIM Servlet (SCIM HTTPS Connection Handler) [from ThirdPartyHTTPServletExtension:SCIM (Aleph)] ds-extension-monitor-name: SCIM Servlet (SCIM HTTPS Connection Handler) ds-extension-type: ThirdPartyHTTPServletExtension ds-extension-name: SCIM (Aleph) version: 1.2.0 build: 20120105174457Z revision: 820 schema-resource-query-successful: 8 schema-resource-query-401: 8 schema-resource-query-response-json: 16 user-resource-delete-successful: 1 user-resource-put-content-xml: 27 user-resource-query-response-json: 3229836 user-resource-put-403: 5 user-resource-put-content-json: 2 user-resource-get-401: 1 user-resource-put-response-json: 23 user-resource-get-response-json: 5 user-resource-get-response-xml: 7 user-resource-put-400: 2 user-resource-query-401: 1141028 user-resource-post-content-json: 1 user-resource-put-successful: 22 user-resource-post-successful: 1 user-resource-delete-404: 1 user-resource-query-successful: 2088808 user-resource-get-successful: 10 user-resource-put-response-xml: 6 user-resource-get-404: 1 user-resource-delete-401: 1 user-resource-post-response-json: 1 host-resource-query-successful: 5773268 host-resource-query-response-json: 11576313 host-resource-query-400: 3 host-resource-query-response-xml: 5 host-resource-query-401: 5788152 dn: cn=SCIM Servlet (SCIM HTTP Connection Handler),cn=monitor objectClass: top objectClass: ds-monitor-entry objectClass: scim-servlet-monitor-entry objectClass: extensibleObject cn: SCIM Servlet (SCIM HTTPS Connection Handler) [from ThirdPartyHTTPServletExtension:SCIM (Beth)] ds-extension-monitor-name: SCIM Servlet (SCIM HTTPS Connection Handler) ds-extension-type: ThirdPartyHTTPServletExtension ds-extension-name: SCIM (Beth) version: 1.2.0 build: 20120105174457Z revision: 820 serviceproviderconfig-resource-get-successful: 3 serviceproviderconfig-resource-get-response-json: 2 serviceproviderconfig-resource-get-response-xml: 1 schema-resource-query-successful: 8 schema-resource-query-401: 8 schema-resource-query-response-json: 16 group-resource-query-successful: 245214 group-resource-query-response-json: 517841 group-resource-query-400: 13711 group-resource-query-401: 258916 user-resource-query-response-json: 107876 user-resource-query-400: 8288 user-resource-get-400: 33 user-resource-get-response-json: 1041 user-resource-get-successful: 2011 user-resource-query-successful: 45650 user-resource-get-response-xml: 1003 user-resource-query-401: 53938 dn: cn=SCIM Servlet (SCIM HTTP Connection Handler),cn=monitor objectClass: top objectClass: ds-monitor-entry objectClass: scim-servlet-monitor-entry objectClass: extensibleObject cn: SCIM Servlet (SCIM HTTPS Connection Handler) [from ThirdPartyHTTPServletExtension:SCIM (Gimel)] ds-extension-monitor-name: SCIM Servlet (SCIM HTTPS Connection Handler) ds-extension-type: ThirdPartyHTTPServletExtension ds-extension-name: SCIM (Gimel) version: 1.2.0 build: 20120105174457Z revision: 820 schema-resource-query-successful: 1 schema-resource-query-401: 1 schema-resource-query-response-json: 2 user-resource-query-successful: 65 user-resource-get-successful: 4 user-resource-get-response-json: 6 user-resource-query-response-json: 132 user-resource-get-404: 2 user-resource-query-401: 67