Scan

To conduct a simple scan using the command line, you can execute the following command:

unctl <provider> -s

Make sure to replace <provider> with your actual provider's name. This will perform a quick scan and give you the default status.

Beginning of the scan report
End of the scan report

Filters

  1. Check ID (-c cli option or filter.checks config value):

    % unctl k8s -s -c K8S103 
    ✅ Loaded 1 check(s)
    ✅ Created jobs
    ✅ Collected k8s data
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
                                                                            Running Kubernetes Checks                                                                        
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    In progress: Pod is in CrashLoopBackOff state  |▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶| 100.0%                                
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
                                                                                Checks Scan Report                                                                           
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    |  Resource Namespace  |    Resource Name     |        Check Title         |   Status   |  Severity  |                       Status Extended                        |
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    | awesome-ops          |  awesome-runbooks-   | Pod is in CrashLoopBackOff |    PASS    |  Critical  |                                                              |
    |                      |       dgrph-0        |           state            |            |            |                                                              |
    .....................................................................................................................................................................
    .....................................................................................................................................................................
    | monitoring           |  prometheus-server-  | Pod is in CrashLoopBackOff |    FAIL    |  Critical  | Pod prometheus-server-bc7cbd8c-jzzf5 in namespace monitoring |
    |                      |    bc7cbd8c-jzzf5    |           state            |            |            |          has a container in CrashLoopBackOff state.          |
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    | sbox-yura            |   util-57cd568c54-   | Pod is in CrashLoopBackOff |    FAIL    |  Critical  |    Pod util-57cd568c54-6jk6s in namespace sbox-yura has a    |
    |                      |        6jk6s         |           state            |            |            |             container in CrashLoopBackOff state.             |
    .....................................................................................................................................................................
    .....................................................................................................................................................................
    | traceable-test       |  temporal-matching-  | Pod is in CrashLoopBackOff |    PASS    |  Critical  |                                                              |
    |                      |   9848dc7d6-ndz4g    |           state            |            |            |                                                              |
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    | traceable-test       |      workflows-      | Pod is in CrashLoopBackOff |    PASS    |  Critical  |                                                              |
    |                      |   854d765d69-hwfpm   |           state            |            |            |                                                              |
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
                                                                                End of Scan Report                                                                           
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    
    Do You want enter interactive mode to continue? (Y/n)
    > n
    
    ✅ Checks: 1
    ❌ Total failures: 2
  2. Failed only (-f cli option or filter.failed_only config value):

    % unctl k8s -sf -c K8S103
    ✅ Loaded 1 check(s)
    ✅ Created jobs
    ✅ Collected k8s data
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
                                                                            Running Kubernetes Checks                                                                        
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    In progress: Pod is in CrashLoopBackOff state  |▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶▶| 100.0%                                
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
                                                                                Checks Scan Report                                                                           
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    
    ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    |  Resource Namespace  |   Resource Name    |        Check Title         |   Status   |  Severity  |                       Status Extended                        |
    ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    | monitoring           | prometheus-server- | Pod is in CrashLoopBackOff |    FAIL    |  Critical  | Pod prometheus-server-bc7cbd8c-jzzf5 in namespace monitoring |
    |                      |   bc7cbd8c-jzzf5   |           state            |            |            |          has a container in CrashLoopBackOff state.          |
    ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    | sbox-yura            |  util-57cd568c54-  | Pod is in CrashLoopBackOff |    FAIL    |  Critical  |    Pod util-57cd568c54-6jk6s in namespace sbox-yura has a    |
    |                      |       6jk6s        |           state            |            |            |             container in CrashLoopBackOff state.             |
    ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
                                                                                End of Scan Report                                                                           
    ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    
    Do You want enter interactive mode to continue? (Y/n)
    > n
    
    ✅ Checks: 1
    ❌ Total failures: 2
  3. Category (--categories cli option or filter.categories config value):

    % unctl k8s -sf --categories Health
    ✅ Loaded 8 check(s)
    ✅ Created jobs
    ✅ Collected k8s data
    
    ..................................................................................
    ..................................................................................
    
    ✅ Checks: 8
    ❌ Total failures: 64
  4. Service (--services cli option or filter.services config value):

    % unctl k8s -sf --services pod     
    ✅Loaded 6 check(s) 
    ✅ Created jobs 
    ✅ Collected k8s data
    .................................................................................. 
    ..................................................................................
    ✅ Checks: 6 
    ❌ Total failures: 36

Ignore

  1. Check ID (--ignore cli option or ignore.checks config value):

    % unctl k8s -sf --ignore K8S103
    ✅ Loaded 30 check(s)
    ✅ Created jobs
    ✅ Collected k8s data
    .................................................................................. 
    ..................................................................................
    ✅ Checks: 30
    ❌ Total failures: 283
  2. Object (--ignore-object cli option or ignore.objects config value):

    % unctl k8s -sf --ignore-object workflows skynet    
    ✅Loaded 31 check(s) 
    ✅ Created jobs 
    ✅ Collected k8s data
    .................................................................................. 
    ..................................................................................
    ✅ Checks: 31 
    ❌ Total failures: 270

Last updated