Sentry uses Codahale to present the metrics.
Enabling metrics and configuration parameters
You need to enable the sentry web server in order to view the sentry metrics.
Make the below changes in sentry-site.xml to enable sentry web server and restart the sentry service.
Config Property | Value | Default | Required |
|---|---|---|---|
| sentry.service.web.enable | true | false | Yes |
| sentry.service.web.port | 51000 | 51000 | No |
| sentry.service.web.authentication.type | KERBEROS or NONE | NONE | Yes |
To view the metrics go to <Sentry-Role-Host>:51000/metrics?pretty=true.
Additional JMX/Console output:
Apart from viewing the metrics on the web page, you can enable a reporter to show the current metrics.
Config Property | Value | Default | Required |
|---|---|---|---|
| sentry.service.reporter | JMX or Console | Yes |
HDFS Sync related metrics
(Defined in SentryHdfsMetricsUtil.java)
API end point metrics
| Metric type | Metric name | Details |
|---|---|---|
| Histogram | org.apache.sentry.hdfs.SentryHDFSServiceProcessor.handle-hms-notification | Time taken for Sentry end point to process path updates from HMS |
| Histogram | org.apache.sentry.hdfs.SentryHDFSServiceProcessor.get-all-authz-updates-from | Time taken for Sentry to serve NN requests for updates |
Internal routine metrics
Scale metrics
| Histogram | org.apache.sentry.hdfs.SentryHDFSServiceProcessor.perm-updates-size | The size of perm updates for each get_all_authz_updates_from |
| Type | Metric type | Metric name | Details |
|---|---|---|---|
| Time taken for an API call | Histogram | org.apache.sentry.hdfs.SentryHDFSServiceProcessor.handle-hms-notification | Time taken for Sentry end point to process path updates from HMS |
| Time taken for an API call | Histogram | org.apache.sentry.hdfs.SentryHDFSServiceProcessor.get-all-authz-updates-from | Time taken for Sentry to serve NN requests for updates |
| Time taken for an internal routine | org.apache.sentry.hdfs.MetastorePlugin.notify-sentry-HMS-update | Time taken for HMS to send an update to Sentry | |
| Time taken for an internal routine | org.apache.sentry.hdfs.MetastorePlugin.apply-local-update | Time taken for HMS to apply the path update locally | |
org.apache.sentry.hdfs.SentryHDFSServiceProcessor.paths-updates-size | The size of path updates for each get_all_authz_updates_from | ||
org.apache.sentry.hdfs.SentryHDFSServiceProcessor.handle-hms-notification.path-changes-size | The size of path changes for each handle_hms_notification | ||
org.apache.sentry.hdfs.MetastorePlugin.apply-local-update.path-change-size | |||
| Error counters | "org.apache.sentry.hdfs.MetastorePlugin.notify-sentry-HMS-update.failed-num" | ||
"org.apache.sentry.hdfs.SentryHDFSServiceProcessor.handle-hms-notification.failed-num" | |||
"org.apache.sentry.hdfs.SentryHDFSServiceProcessor.handle-hms-notification.has-full-image-num" |
Sentry Service related metrics:
Gauges- A gauge is an instantaneous measurement of a value
Sentry Service Gauges:
Gauge | Type |
|---|---|
org.apache.sentry.service.thrift.SentryService.is_active | boolean |
org.apache.sentry.service.thrift.SentryService.is_ha | boolean |
Sentry Store Gauges:
Gauge | Type |
|---|---|
org.apache.sentry.provider.db.service.persistent.SentryStore.group_count | Long |
org.apache.sentry.provider.db.service.persistent.SentryStore.privilege_count | Long |
org.apache.sentry.provider.db.service.persistent.SentryStore.role_count | Long |