1
0
mirror of https://github.com/minio/docs.git synced 2025-09-10 20:12:12 +03:00
Files
docs/source/reference/minio-mc-admin/mc-admin-scanner-status.rst
2024-10-08 11:55:48 -04:00

133 lines
4.2 KiB
ReStructuredText

===========================
``mc admin scanner status``
===========================
.. default-domain:: minio
.. contents:: Table of Contents
:local:
:depth: 2
.. mc:: mc admin scanner info
.. mc:: mc admin scanner status
Description
-----------
.. start-mc-admin-scanner-status-desc
The :mc-cmd:`mc admin scanner status` command displays a real-time summary of :ref:`scanner <minio-concepts-scanner>` information for a MinIO Server.
.. end-mc-admin-scanner-status-desc
This command has an alias of ``mc admin scanner info``.
.. admonition:: Use ``mc admin`` on MinIO Deployments Only
:class: note
.. include:: /includes/facts-mc-admin.rst
:start-after: start-minio-only
:end-before: end-minio-only
.. tab-set::
.. tab-item:: EXAMPLE
The following example returns information about the current state of the scanner process.
.. code-block:: shell
:class: copyable
mc admin scanner status myminio
The command returns results similar to the following:
.. code-block:: shell
Overall Statistics
------------------
Last full scan time: 0d0h15m; Estimated 2879.79/month
Current cycle: (between cycles)
Active drives: 0
Last Minute Statistics
----------------------
Objects Scanned: 3 objects; Avg: 67.611µs; Rate: 4320/day
Versions Scanned: 3 versions; Avg: 2.506µs; Rate: 4320/day
Versions Heal Checked: 0 versions; Avg: 0ms
Read Metadata: 3 objects; Avg: 40.817µs, Size: 395 bytes/obj
ILM checks: 3 versions; Avg: 714ns
Check Replication: 3 versions; Avg: 892ns
Verify Deleted: 0 folders; Avg: 0ms
Yield: 18ms total; Avg: 6ms/obj
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc admin scanner status ALIAS
[--bucket <string>] \
[--interval <value>] \
[--max-paths <value>] \
[-n <integer>] \
[--nodes <string>]
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
:end-before: end-minio-syntax
Parameters
~~~~~~~~~~
.. mc-cmd:: ALIAS
:required:
The :ref:`alias <alias>` of the MinIO deployment for which to display :ref:`scanner <minio-concepts-scanner>` API operations.
.. mc-cmd:: --bucket
:optional:
Filter scanner statistics to the specified bucket.
.. mc-cmd:: --interval
:optional:
The number of seconds to wait between status request refreshes.
If not specified, the status refreshes every 3 seconds.
.. mc-cmd:: --max-paths
:optional:
The maximum number of active paths to show.
Use ``-1`` for an unlimited number of paths.
Limiting the number of paths shown can reduce the scrolling of the console window when there are a large number of drives being scanned.
If not specified, the results return for an unlimited number of active paths.
.. mc-cmd:: -n
:optional:
The number of status requests to return before automatically exiting.
Use ``0`` to return an unlimited number of status results.
If not specified, the results continuously refresh at the specified interval until manually exited.
.. mc-cmd:: --nodes
:optional:
Returns scanner status information for the specified node(s).
Specify multiple nodes as a comma-separated list.
Global Flags
~~~~~~~~~~~~
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-mc-globals
:end-before: end-minio-mc-globals