THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
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 |
Scale metrics
org.apache.sentry.hdfs.SentryHDFSServiceProcessor.paths-updates-size | The size of path updates for each get_all_authz_updates_from | |
Histogram | org.apache.sentry.hdfs.SentryHDFSServiceProcessor.perm-updates-size | The size of perm 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 |
Internal routine metrics
| Metric type | Metric name | Details |
|---|---|---|
org.apache.sentry.hdfs.MetastorePlugin.notify-sentry-HMS-update | Time taken for HMS to send an update to Sentry | |
org.apache.sentry.hdfs.MetastorePlugin.apply-local-update | Time taken for HMS to apply the path update locally |
Error counters
| Metric type | Metric name | Details |
|---|---|---|
| "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
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 |
Legend
Gauges - A gauge is an instantaneous measurement of a value