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
We're working on SAAS version of kwatch that provides User interface, optimized notifications, more details about crashes, and more. You can join the waitlist to get early access!
helm repo add kwatch https://kwatch.dev/charts
helm install [RELEASE_NAME] kwatch/kwatch --namespace kwatch --create-namespace --version 0.8.5
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.8.5/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.8.5/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 comma separated 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 !<namespace name> . You can either set forbidden namespaces or allowed, not both. |
reasons |
Optional comma separated 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 !<reason> . 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 comma separated list of container names to ignore |
ignorePodNames |
Optional list of pod name regexp patterns 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 |
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) |
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 DingTalk, provide accessToken with optional secret and title
Parameter | Description |
---|---|
alert.dingtalk.accessToken |
Chat access token |
alert.dingtalk.secret |
Optional secret used to sign requests |
alert.dingtalk.title |
Customized title in message |
Parameter | Description |
---|---|
alert.feishu.webhook |
FeiShu bot webhook URL |
alert.feishu.title |
Customized title in message |
If you want to enable custom webhook, provide url with optional headers and basic auth
Parameter | Description |
---|---|
alert.webhook.url |
Webhook URL |
alert.webhook.headers |
optional list of name and value |
alert.webhook.basicAuth |
optional username and password |
kubectl delete -f https://raw.githubusercontent.com/abahmed/kwatch/v0.8.5/deploy/config.yaml
kubectl delete -f https://raw.githubusercontent.com/abahmed/kwatch/v0.8.5/deploy/deploy.yaml
kwatch is being used by multiple entities including, but not limited to
If you want to add your entity, open issue to add it
Feel free to chat with us on Discord if you have questions, or suggestions
kwatch is licensed under MIT License