kwatch helps you monitor all changes in your Kubernetes(K8s) cluster, detects crashes in your running apps in realtime, and publishes notifications to your channels (Slack, Discord, etc.) instantly
helm repo add kwatch https://kwatch.dev/charts helm install [RELEASE_NAME] kwatch/kwatch --namespace kwatch --create-namespace --version 0.10.1
To get more details, please check chart’s configuration
You need to get config template to add your configs
curl -L https://raw.githubusercontent.com/abahmed/kwatch/v0.10.1/deploy/config.yaml -o config.yaml
Then edit config.yaml file and apply your configuration
kubectl apply -f config.yaml
To deploy kwatch, execute following command:
kubectl apply -f https://raw.githubusercontent.com/abahmed/kwatch/v0.10.1/deploy/deploy.yaml
| Parameter | Description |
|---|---|
maxRecentLogLines |
Optional Max tail log lines in messages, if it’s not provided it will get all log lines |
namespaces |
Optional list of namespaces that you want to watch or forbid, if it’s not provided it will watch all namespaces. If you want to forbid a namespace, configure it with !. You can either set forbidden namespaces or allowed, not both. |
reasons |
Optional list of reasons that you want to watch or forbid, if it’s not provided it will watch all reasons. If you want to forbid a reason, configure it with !. You can either set forbidden reasons or allowed, not both. |
ignoreFailedGracefulShutdown |
If set to true, containers which are forcefully killed during shutdown (as their graceful shutdown failed) are not reported as error |
ignoreContainerNames |
Optional list of container names to ignore |
ignorePodNames |
Optional list of pod name regexp patterns to ignore |
IgnoreLogPatterns |
Optional list of regexp patterns of logs to ignore |
| Parameter | Description |
|---|---|
app.proxyURL |
used in outgoing http(s) requests except Kubernetes requests to cluster optionally |
app.clusterName |
used in notifications to indicate which cluster has issue |
app.disableStartupMessage |
If set to true, welcome message will not be sent to notification channels |
app.logFormatter |
used for setting custom formatter when app prints logs: text, json (default: text) |
| Parameter | Description |
|---|---|
upgrader.disableUpdateCheck |
If set to true, does not check for and notify about kwatch updates |
| Parameter | Description |
|---|---|
pvcMonitor.enabled |
to enable or disable this module (default: true) |
pvcMonitor.interval |
the frequency (in minutes) to check pvc usage in the cluster (default: 15) |
pvcMonitor.threshold |
the percentage of accepted pvc usage. if current usage exceeds this value, it will send a notification (default: 80) |
| Parameter | Description |
|---|---|
nodeMonitor.enabled |
to enable or disable node monitoring (default: true) |
If you want to enable Slack, provide the webhook with optional text and title
| Parameter | Description |
|---|---|
alert.slack.webhook |
Slack webhook URL |
alert.slack.channel |
Used by legacy webhooks to send messages to specific channel instead of default one |
alert.slack.title |
Customized title in slack message |
alert.slack.text |
Customized text in slack message |
If you want to enable Discord, provide the webhook with optional text and title
| Parameter | Description |
|---|---|
alert.discord.webhook |
Discord webhook URL |
alert.discord.title |
Customized title in discord message |
alert.discord.text |
Customized text in discord message |
If you want to enable Email, provide the from and to emails with host and the port
| Parameter | Description |
|---|---|
alert.email.from |
From email |
alert.email.password |
From email Password |
alert.email.host |
provide the host |
alert.email.port |
provide the port |
alert.email.to |
the receiver email |
If you want to enable PagerDuty, provide the integration key
| Parameter | Description |
|---|---|
alert.pagerduty.integrationKey |
PagerDuty integration key more info |
If you want to enable Telegram, provide a valid token and the chat Id.
| Parameter | Description |
|---|---|
alert.telegram.token |
Telegram token |
alert.telegram.chatId |
Telegram chat id |
If you want to enable Microsoft Teams, provide the channel webhook.
| Parameter | Description |
|---|---|
alert.teams.webhook |
webhook Microsoft team |
alert.teams.title |
Customized title in Microsoft teams message |
alert.teams.text |
Customized title in Microsoft teams message |
If you want to enable Rocket Chat, provide the webhook with optional text
| Parameter | Description |
|---|---|
alert.rocketchat.webhook |
Rocket Chat webhook URL |
alert.rocketchat.text |
Customized text in rocket chat message |
If you want to enable Mattermost, provide the webhook with optional text and title
| Parameter | Description |
|---|---|
alert.mattermost.webhook |
Mattermost webhook URL |
alert.mattermost.title |
Customized title in Mattermost message |
alert.mattermost.text |
Customized text in Mattermost message |
If you want to enable Opsgenie, provide the API key with optional text and title
| Parameter | Description |
|---|---|
alert.opsgenie.apiKey |
Opsgenie API Key |
alert.opsgenie.title |
Customized title in Opsgenie message |
alert.opsgenie.text |
Customized text in Opsgenie message |
If you want to enable Matrix, provide homeServer, accessToken and internalRoomID
with optional text and title
| Parameter | Description |
|---|---|
alert.matrix.homeServer |
HomeServer URL |
alert.matrix.accessToken |
Account access token |
alert.matrix.internalRoomID |
Internal room ID |
alert.matrix.title |
Customized title in message |
alert.matrix.text |
Customized text in message |
If you want to enable DingTa
