insight info

Prints the status of the component types and retention days for purging with respect to the insight service.

The insight info subcommand displays detailed information related to the following:

  • whether the component types are enabled/disabled.
  • The time the audit data was last added to the respective Iceberg table, along with relevant status code and a message in case of error.
  • The clean-up time activity of older audit data based on the specified retentionDays.
    NOTE
    The value of retentionDays would be as configured by using the insight purge command.

Syntax

CLI
maprcli insight
info
	[ -nodes node names space separated ]
	[ -type audit type [mfs, s3, auth, cldb] ],
	[ -purge true/false ]
REST
Request Type GET
Request URL
http[s]://<host>:<port>/rest/insight/info?<parameters>

Parameters

Parameter Description
nodes (Optional) The node name for which the information from the insight service is to be displayed. Specifying this option implies that status for all the components is to be displayed for the specified node. This option cannot be used in combination with the type option.
type (Optional) The audit component type for which the information from the insight service is to be displayed. The permissible values are mfs for file server logs, s3 for S3 object store logs, cldb for cldb logs and auth for web server authentication logs. Use comma-separated list for more than one audit log type. When type-level insights are enabled/disabled, the configuration is effective for the type across all nodes in the cluster.

This option cannot be used in combination with node option.

purge (Optional) Use this option to view the purge activity of insight service. It is used to display the retentionDays, purge activity time related to the purge. The permissible values are true or false.

true denotes that only the purge information should be displayed in the command output.

Purge is enabled automatically for the components that have been enabled using insight cluster command.

Example

NOTE
In the sample outputs given below, the value Stream for the insight mode field indicates that the trial mode is enabled for the insights feature. The value File for the insight mode field indicates that the production mode is enabled for the insights feature.

Display all insight information as a well-formatted output (node-wise component and purge details).

maprcli insight info -json
{
        "timestamp":1729500123553,
        "timeofday":"2024-10-21 01:42:03.553 GMT-0700 AM",
        "status":"OK",
        "total":1,
        "data":[
                {
                        "insight mode":"Stream",
                        "cluster":{
                                "mfs":false,
                                "cldb":true,
                                "s3":false,
                                "auth":false
                        },
                        "nodes":{
                                "m2-mapreng-vm0905.mip.storage.hpecorp.net":{
                                        "enabled":true,
                                        "mfs":{
                                                "running":false,
                                                "lastCommitTime":""
                                        },
                                        "cldb":{
                                                "running":true,
                                                "status":0,
                                                "lastCommitTime":""
                                        },
                                        "s3":{
                                                "running":false,
                                                "lastCommitTime":""
                                        },
                                        "auth":{
                                                "running":false,
                                                "lastCommitTime":""
                                        }
                                }
                        },
                        "purge":{
                                "cldb":{
                                        "node":"m2-mapreng-vm16655.mip.storage.hpecorp.net",
                                        "attemptTime":"2024-10-21 01:23:19.420 GMT-0700",
                                        "finishTime":"2024-10-21 01:23:20.604 GMT-0700",
                                        "snapsEpoch":"2024-10-16 01:23:19.420 GMT-0700"
                                },
                                "retentionDays":5
                        }
                }
        ]
}

Display insight purge details only.

maprcli insight info -purge true -json
{
        "timestamp":1729500312908,
        "timeofday":"2024-10-21 01:45:12.908 GMT-0700 AM",
        "status":"OK",
        "total":1,
        "data":[
                {
                        "insight mode":"File",
                        "cluster":{
                                "mfs":false,
                                "cldb":true,
                                "s3":false,
                                "auth":false
                        },
                        "purge":{
                                "cldb":{
                                        "node":"m2-mapreng-vm9605.mip.storage.hpecorp.net",
                                        "attemptTime":"",
                                        "finishTime":"",
                                        "snapsEpoch":""
                                },
                                "retentionDays":5
                        }
                }
        ]
}

Display insight information pertaining to the specified component

maprcli insight info -type cldb, mfs -json
{
        "timestamp":1729500399670,
        "timeofday":"2024-10-21 01:46:39.670 GMT-0700 AM",
        "status":"OK",
        "total":1,
        "data":[
                {
                        "insight mode":"File",
                        "cluster":{
                                "mfs":false,
                                "cldb":true,
                                "s3":false,
                                "auth":false
                        },
                        "nodes":{
                                "m2-mapreng-vm16655.mip.storage.hpecorp.net":{
                                        "enabled":true,
                                        "cldb":{
                                                "running":true,
                                                "status":0,
                                                "lastCommitTime":""
                                        },
                                        "mfs":{
                                                "running":false,
                                                "lastCommitTime":""
                                        }
                                }
                        }
                }
        ]
}