OS Manuals

/usr/bin/reports-controller

From kyverno-reports-controller-1.17 1.17.2-r1 (os), captured 2026-11-05 by running reports-controller --help (exit 0). permalink

Usage of /usr/bin/reports-controller:
  -add_dir_header
    	If true, adds the file directory to the header of the log messages
  -admissionReports
    	Enable or disable admission reports. (default true)
  -aggregateReports
    	Enable or disable aggregated policy reports. (default true)
  -aggregationWorkers int
    	Configure the number of ephemeral reports aggregation workers. (default 10)
  -allowInsecureRegistry
    	Whether to allow insecure connections to registries. Don't use this for anything but testing.
  -allowedResults string
    	Comma separated list of result types for which creating reports is desired. (pass,fail,error,warn,skip) (default "pass,fail,error,warn,skip")
  -alsologtostderr
    	log to standard error as well as files (no effect when -logtostderr=true)
  -autoMemLimitEnabled
    	Enable automatic GOMEMLIMIT configuration based on container or system memory. (default true)
  -autoMemLimitRatio float
    	The ratio of reserved GOMEMLIMIT memory to the detected maximum container or system memory. Must be greater than 0 and less than or equal to 1. (default 0.9)
  -backgroundScan
    	Enable or disable background scan. (default true)
  -backgroundScanInterval duration
    	Configure background scan interval. (default 1h0m0s)
  -backgroundScanWorkers int
    	Configure the number of background scan workers. (default 2)
  -cleanupServerHost string
    	Host used by the cleanup server. If not set, it will default to [::] for IPv6 or 0.0.0.0 for IPv4.
  -cleanupServerPort int
    	kyverno cleanup server port, defaults to '9443'. (default 9443)
  -clientRateLimitBurst int
    	Configure the maximum burst for throttle. Uses the client default if zero. (default 300)
  -clientRateLimitQPS float
    	Configure the maximum QPS to the Kubernetes API server from Kyverno. Uses the client default if zero. (default 300)
  -crdWatcher
    	Enable watching of custom resources to invalidate discovery cache on changes.
  -disableLogColor
    	Disable colored output in logs.
  -disableMetrics
    	Set this flag to 'true' to disable metrics.
  -enableConfigMapCaching
    	Enable config maps caching. (default true)
  -enableDeferredLoading value
    	enable deferred loading of context variables
  -enablePolicyException
    	Enable PolicyException feature.
  -enableReporting string
    	Comma separated list to enable reporting for different rule types. (validate,mutate,mutateExisting,generate,imageVerify) (default "validate,mutate,mutateExisting,generate,imageVerify")
  -enableTracing
    	Set this flag to 'true', to enable tracing.
  -enableTuf
    	enable tuf for private sigstore deployments
  -eventsRateLimitBurst int
    	Configure the maximum burst for throttle for events. Uses the client default if zero. (default 2000)
  -eventsRateLimitQPS float
    	Configure the maximum QPS to the Kubernetes API server from Kyverno for events. Uses the client default if zero. (default 1000)
  -exceptionNamespace string
    	Configure the namespace to accept PolicyExceptions. If it is set to '*', exceptions are allowed in all namespaces.
  -imagePullSecrets string
    	Secret resource names for image registry access credentials.
  -imageVerifyCacheEnabled
    	Enable a TTL cache for verified images. (default true)
  -imageVerifyCacheMaxSize int
    	Maximum number of keys that can be stored in the TTL cache. Keys are a combination of policy elements along with the image reference. Default is 1000. 0 sets the value to default. (default 1000)
  -imageVerifyCacheTTLDuration duration
    	Maximum TTL value for a cache expressed as duration. Default is 60m. 0 sets the value to default. (default 1h0m0s)
  -kubeconfig string
    	Paths to a kubeconfig. Only required if out-of-cluster.
  -leaderElectionRetryPeriod duration
    	Configure leader election retry period. (default 2s)
  -log_backtrace_at value
    	when logging hits line file:N, emit a stack trace
  -log_dir string
    	If non-empty, write log files in this directory (no effect when -logtostderr=true)
  -log_file string
    	If non-empty, use this log file (no effect when -logtostderr=true)
  -log_file_max_size uint
    	Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
  -loggingFormat string
    	This determines the output format of the logger. (default "text")
  -loggingtsFormat string
    	This determines the timestamp format of the logger. (default "default")
  -logtostderr
    	log to standard error instead of files (default true)
  -maxAPICallResponseLength int
    	Maximum allowed response size from API Calls. A value of 0 bypasses checks (not recommended). (default 2000000)
  -maxBackgroundReports int
    	Maximum number of ephemeralreports created for the background policies before we stop creating new ones (default 10000)
  -maxQueuedEvents int
    	Maximum events to be queued. (default 1000)
  -metricsHost string
    	Expose prometheus metrics at the given host. If not set, it will default to [::] for IPv6 or 0.0.0.0 for IPv4.
  -metricsPort int
    	Expose prometheus metrics at the given port, default to 8000. (default 8000)
  -mutatingAdmissionPolicyReports
    	Enable or disable MutatingAdmissionPolicy reports.
  -omitEvents string
    	Set this flag to a comma separated list of PolicyViolation, PolicyApplied, PolicyError, PolicySkipped to disable events, e.g. --omitEvents=PolicyApplied,PolicyViolation
  -one_output
    	If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
  -openreportsEnabled
    	Use openreports.io/v1alpha1 for the reporting group
  -otelCollector string
    	Set this flag to the OpenTelemetry Collector Service Address. Kyverno will try to connect to this on the metrics port. (default "opentelemetrycollector.kyverno.svc.cluster.local")
  -otelConfig string
    	Set this flag to 'grpc', to enable exporting metrics to an Opentelemetry Collector. The default collector is set to "prometheus" (default "prometheus")
  -policyReports
    	Enable or disable policy reports. (default true)
  -profile
    	Set this flag to 'true', to enable profiling.
  -profileAddress string
    	Profiling server address, defaults to ''.
  -profilePort string
    	Profiling server port, defaults to '6060'. (default "6060")
  -registryCredentialHelpers string
    	Credential helpers to enable (default,google,amazon,azure,github). No helpers are added when this flag is empty.
  -reportsCRDsSanityChecks
    	Enable or disable sanity checks for policy reports and ephemeral reports CRDs. (default true)
  -resyncPeriod duration
    	Configure the resync period for informer factory (default 15m0s)
  -skipResourceFilters
    	If true, resource filters wont be considered. (default true)
  -skip_headers
    	If true, avoid header prefixes in the log messages
  -skip_log_headers
    	If true, avoid headers when opening log files (no effect when -logtostderr=true)
  -stderrthreshold value
    	logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true) (default 2)
  -tracingAddress string
    	Tracing receiver address, defaults to ''.
  -tracingCreds string
    	Set this flag to the CA secret containing the certificate which is used by our Opentelemetry Tracing Client. If empty string is set, means an insecure connection will be used
  -tracingPort string
    	Tracing receiver port, defaults to '4317'. (default "4317")
  -transportCreds string
    	Set this flag to the CA secret containing the certificate which is used by our Opentelemetry Metrics Client. If empty string is set, means an insecure connection will be used
  -tufMirror string
    	Alternate TUF mirror for sigstore. If left blank, public sigstore one is used for cosign verification. (default "https://tuf-repo-cdn.sigstore.dev")
  -tufRoot string
    	Path to alternate TUF root.json for sigstore (url or env). If left blank, public sigstore one is used for cosign verification.
  -tufRootRaw string
    	The raw body of alternate TUF root.json for sigstore. If left blank, public sigstore one is used for cosign verification.
  -v value
    	number for the log level verbosity
  -validatingAdmissionPolicyReports
    	Enable or disable ValidatingAdmissionPolicy reports. (default true)
  -vmodule value
    	comma-separated list of pattern=N settings for file-filtered logging
Options (73)
OptionDescriptionSource
-add_dir_headerIf true, adds the file directory to the header of the log messageshelp
-admissionReportsEnable or disable admission reports.help
-aggregateReportsEnable or disable aggregated policy reports.help
-aggregationWorkers intConfigure the number of ephemeral reports aggregation workers.help
-allowInsecureRegistryWhether to allow insecure connections to registries.help
-allowedResults stringComma separated list of result types for which creating reports is desired.help
-alsologtostderrlog to standard error as well as files (no effect when -logtostderr=true)help
-autoMemLimitEnabledEnable automatic GOMEMLIMIT configuration based on container or system memory.help
-autoMemLimitRatio floatThe ratio of reserved GOMEMLIMIT memory to the detected maximum container or system memory.help
-backgroundScanEnable or disable background scan.help
-backgroundScanInterval durationConfigure background scan interval.help
-backgroundScanWorkers intConfigure the number of background scan workers.help
-cleanupServerHost stringHost used by the cleanup server.help
-cleanupServerPort intkyverno cleanup server port, defaults to '9443'.help
-clientRateLimitBurst intConfigure the maximum burst for throttle.help
-clientRateLimitQPS floatConfigure the maximum QPS to the Kubernetes API server from Kyverno.help
-crdWatcherEnable watching of custom resources to invalidate discovery cache on changes.help
-disableLogColorDisable colored output in logs.help
-disableMetricsSet this flag to 'true' to disable metrics.help
-enableConfigMapCachingEnable config maps caching.help
-enableDeferredLoading valueenable deferred loading of context variableshelp
-enablePolicyExceptionEnable PolicyException feature.help
-enableReporting stringComma separated list to enable reporting for different rule types.help
-enableTracingSet this flag to 'true', to enable tracing.help
-enableTufenable tuf for private sigstore deploymentshelp
-eventsRateLimitBurst intConfigure the maximum burst for throttle for events.help
-eventsRateLimitQPS floatConfigure the maximum QPS to the Kubernetes API server from Kyverno for events.help
-exceptionNamespace stringConfigure the namespace to accept PolicyExceptions.help
-imagePullSecrets stringSecret resource names for image registry access credentials.help
-imageVerifyCacheEnabledEnable a TTL cache for verified images.help
-imageVerifyCacheMaxSize intMaximum number of keys that can be stored in the TTL cache.help
-imageVerifyCacheTTLDuration durationMaximum TTL value for a cache expressed as duration.help
-kubeconfig stringPaths to a kubeconfig.help
-leaderElectionRetryPeriod durationConfigure leader election retry period.help
-log_backtrace_at valuewhen logging hits line file:N, emit a stack tracehelp
-log_dir stringIf non-empty, write log files in this directory (no effect when -logtostderr=true)help
-log_file stringIf non-empty, use this log file (no effect when -logtostderr=true)help
-log_file_max_size uintDefines the maximum size a log file can grow to (no effect when -logtostderr=true).help
-loggingFormat stringThis determines the output format of the logger.help
-loggingtsFormat stringThis determines the timestamp format of the logger.help
-logtostderrlog to standard error instead of files (default true)help
-maxAPICallResponseLength intMaximum allowed response size from API Calls.help
-maxBackgroundReports intMaximum number of ephemeralreports created for the background policies before we stop creating new ones (default 10000)help
-maxQueuedEvents intMaximum events to be queued.help
-metricsHost stringExpose prometheus metrics at the given host.help
-metricsPort intExpose prometheus metrics at the given port, default to 8000.help
-mutatingAdmissionPolicyReportsEnable or disable MutatingAdmissionPolicy reports.help
-omitEvents stringSet this flag to a comma separated list of PolicyViolation, PolicyApplied, PolicyError, PolicySkipped to disable events, e.g. --omitEvents=PolicyApplied,PolicyViolationhelp
-one_outputIf true, only write logs to their native severity level (vs also writing to each lower severity level;help
-openreportsEnabledUse openreports.io/v1alpha1 for the reporting grouphelp
-otelCollector stringSet this flag to the OpenTelemetry Collector Service Address.help
-otelConfig stringSet this flag to 'grpc', to enable exporting metrics to an Opentelemetry Collector.help
-policyReportsEnable or disable policy reports.help
-profileSet this flag to 'true', to enable profiling.help
-profileAddress stringProfiling server address, defaults to ''.help
-profilePort stringProfiling server port, defaults to '6060'.help
-registryCredentialHelpers stringCredential helpers to enable (default,google,amazon,azure,github).help
-reportsCRDsSanityChecksEnable or disable sanity checks for policy reports and ephemeral reports CRDs.help
-resyncPeriod durationConfigure the resync period for informer factory (default 15m0s)help
-skipResourceFiltersIf true, resource filters wont be considered.help
-skip_headersIf true, avoid header prefixes in the log messageshelp
-skip_log_headersIf true, avoid headers when opening log files (no effect when -logtostderr=true)help
-stderrthreshold valuelogs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true) (default 2)help
-tracingAddress stringTracing receiver address, defaults to ''.help
-tracingCreds stringSet this flag to the CA secret containing the certificate which is used by our Opentelemetry Tracing Client.help
-tracingPort stringTracing receiver port, defaults to '4317'.help
-transportCreds stringSet this flag to the CA secret containing the certificate which is used by our Opentelemetry Metrics Client.help
-tufMirror stringAlternate TUF mirror for sigstore.help
-tufRoot stringPath to alternate TUF root.json for sigstore (url or env).help
-tufRootRaw stringThe raw body of alternate TUF root.json for sigstore.help
-v valuenumber for the log level verbosityhelp
-validatingAdmissionPolicyReportsEnable or disable ValidatingAdmissionPolicy reports.help
-vmodule valuecomma-separated list of pattern=N settings for file-filtered logginghelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.