mc support inspect

The mc support inspect command collects the data and metadata associated to objects at the specified path.

If this information is required to diagnose a AIStor SUBNET issue, AIStor Engineering will provide the appropriate command. AIStor assembles this data from each backend drive storing an erasure shard for each specified object. For registered clusters, the file uploads to AIStor for use by the engineering team in support efforts.

The command produces an encrypted zip file that includes all matching files with their respective host+drive+path. When writing the zip archive, AIStor also encrypts the zip index of file names included in the archive. The resulting report is intended for use by AIStor Engineering via SUBNET and may contain internal or private data points associated to the object. Exercise caution before sending a report to a third party or posting the report in a public forum.

The file saves the the current working directory in the event the file does not successfully upload (such as in an airgapped environment).

mc [GLOBALFLAGS] support inspect       \
                         [--legacy]   \
                         TARGET

mc support inspect minio1/mybucket/myobject/xl.meta

The command supports wildcard * pattern matching for prefixes or objects when using the Bash shell. For non-Bash shells, a message displays indicating that wildcard patterns are only supported in Bash.

mc support inspect ALIAS/bucket/path/**/xl.meta

This command collects all xl.meta associated to objects at ALIAS/bucket/path/.

You can download the metadata for an object. Metadata stores in an xl.meta binary file.

The following command downloads the xl.meta from mybucket/myobject on the minio1 deployment.

The file downloads from all drives as a zip archive file.

mc support inspect minio1/mybucket/myobject/xl.meta

The contents of the xl.meta file are not human readable. You can convert the contents of an xl.meta file to JSON format.

The following command downloads all objects recursively found at a prefix.

mc support inspect minio1/mybucket/myobject/**

The command has the following syntax:

mc [GLOBALFLAGS] support inspect       \
                         [--legacy]   \
                         TARGET

Optional

Use the older method of exporting inspection data, which does not encrypt data by default.

Required

The path to the location or object to inspect. The path should include the alias of the AIStor deployment and, if needed, the prefix and/or object name.

This command supports any of the global flags.