MATIH Platform is in active MVP development. Documentation reflects current implementation status.
18. CI/CD & Build System
Tooling
Platform Status

Platform Status

The platform-status.sh script provides a comprehensive health diagnostic for the MATIH Kubernetes cluster. It reports pod status summaries, identifies failing pods, and provides per-pod diagnostics with error logs.

Source: scripts/tools/platform-status.sh


Usage

./scripts/tools/platform-status.sh

Diagnostic Functions

FunctionDescription
get_pod_summaryCount pods by status in a namespace
get_failing_podsList pods in error states across namespaces
get_pod_error_logsRetrieve last N log lines for a pod
diagnose_podFull diagnostic for a single failing pod

Failure Detection

The script detects the following pod states as failures:

StateDescription
CrashLoopBackOffContainer repeatedly crashing
ErrorContainer exited with error
ImagePullBackOffCannot pull container image
CreateContainerConfigErrorConfiguration error (missing secret, security context)
Init:Init container failure

Output Format

Namespace Summary

matih-control-plane:
   8 Running
   1 CrashLoopBackOff

matih-data-plane:
  15 Running
   2 Error

Pod Diagnostics

For each failing pod, the script outputs:

Pod: ai-service-abc123 (matih-data-plane)
  Status: CrashLoopBackOff
  Restarts: 5
  Last Error:
    ModuleNotFoundError: No module named 'missing_package'

Checked Namespaces

NamespaceComponents
matih-control-planeCP services, API gateway
matih-data-planeDP services, compute engines
matih-monitoring-control-planeCP monitoring
matih-monitoring-data-planeDP monitoring
matih-ingressIngress controller

Libraries Used

LibraryPurpose
core/logging.shColor-coded output

Related Pages