diff --git a/README.md b/README.md index 4fc1dadd1..129953fb9 100644 --- a/README.md +++ b/README.md @@ -91,6 +91,7 @@ Feel free to ask questions or share your ideas - we'd love to hear from you! - Website monitoring - Page speed monitoring - Infrastructure monitoring (memory, disk usage, CPU performance, network etc) - requires [Capture](https://github.com/bluewave-labs/capture) agent + - Selective disk monitoring with mountpoint selection - Docker monitoring - Ping monitoring - SSL monitoring diff --git a/client/src/Hooks/v1/monitorHooks.js b/client/src/Hooks/v1/monitorHooks.js index 9ee98cc55..8acbea608 100644 --- a/client/src/Hooks/v1/monitorHooks.js +++ b/client/src/Hooks/v1/monitorHooks.js @@ -387,6 +387,7 @@ const useUpdateMonitor = () => { ...(monitor.type === "hardware" && { thresholds: monitor.thresholds, secret: monitor.secret, + selectedDisks: monitor.selectedDisks, }), }; await networkService.updateMonitor({ diff --git a/client/src/Pages/v1/Infrastructure/Create/Components/DiskSelection.jsx b/client/src/Pages/v1/Infrastructure/Create/Components/DiskSelection.jsx new file mode 100644 index 000000000..88b56f966 --- /dev/null +++ b/client/src/Pages/v1/Infrastructure/Create/Components/DiskSelection.jsx @@ -0,0 +1,87 @@ +import React from "react"; +import ConfigBox from "@/Components/v1/ConfigBox/index.jsx"; +import { Box, Stack, Typography } from "@mui/material"; +import Checkbox from "@/Components/v1/Inputs/Checkbox/index.jsx"; +import { useTheme } from "@emotion/react"; +import { useTranslation } from "react-i18next"; +import PropTypes from "prop-types"; + +const DiskSelection = ({ availableDisks, selectedDisks, onChange }) => { + const theme = useTheme(); + const { t } = useTranslation(); + + const handleDiskChange = (event, mountpoint) => { + const isChecked = event.target.checked; + let newSelectedDisks = []; + + if (isChecked) { + newSelectedDisks = [...selectedDisks, mountpoint]; + } else { + newSelectedDisks = selectedDisks.filter((disk) => disk !== mountpoint); + } + + onChange(newSelectedDisks); + }; + + return ( + + + + {t("v1.infrastructure.disk_selection_title")} + + + {t("v1.infrastructure.disk_selection_description")} + + + + + {(!availableDisks || availableDisks.length === 0) ? ( + + {t("v1.infrastructure.disk_selection_info")} + + ) : ( + availableDisks.map((disk) => { + const identifier = disk.mountpoint || disk.device; + return ( + + + handleDiskChange(e, identifier)} + /> + + + ) + }) + )} + + + ); +}; + +DiskSelection.propTypes = { + availableDisks: PropTypes.arrayOf( + PropTypes.shape({ + mountpoint: PropTypes.string.isRequired, + }) + ), + selectedDisks: PropTypes.arrayOf(PropTypes.string).isRequired, + onChange: PropTypes.func.isRequired, +}; + +export default DiskSelection; \ No newline at end of file diff --git a/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureMonitorForm.jsx b/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureMonitorForm.jsx index f0a701517..a38ac9fc6 100644 --- a/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureMonitorForm.jsx +++ b/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureMonitorForm.jsx @@ -17,6 +17,7 @@ const useInfrastructureMonitorForm = () => { temperature: false, usage_temperature: "", secret: "", + selectedDisks: [], }); const onChangeForm = (name, value) => { @@ -48,6 +49,7 @@ const useInfrastructureMonitorForm = () => { temperature: gt.temperature !== undefined, usage_temperature: gt.temperature !== undefined ? gt.temperature.toString() : "", secret: "", + selectedDisks: [], })); }, []); @@ -81,6 +83,7 @@ const useInfrastructureMonitorForm = () => { ? (thresholds.usage_temperature * 100).toString() : "", secret: monitor.secret || "", + selectedDisks: monitor.selectedDisks || [], })); }, []); return { diff --git a/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureSubmit.jsx b/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureSubmit.jsx index 8a97486c7..15a5f3c5d 100644 --- a/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureSubmit.jsx +++ b/client/src/Pages/v1/Infrastructure/Create/hooks/useInfrastructureSubmit.jsx @@ -29,11 +29,11 @@ const useInfrastructureSubmit = () => { ...(infrastructureMonitor.disk ? { usage_disk: infrastructureMonitor.usage_disk } : {}), - temperature: infrastructureMonitor.temperature, ...(infrastructureMonitor.temperature ? { usage_temperature: infrastructureMonitor.usage_temperature } : {}), secret: infrastructureMonitor.secret, + selectedDisks: infrastructureMonitor.selectedDisks, }; return form; }; @@ -52,6 +52,7 @@ const useInfrastructureSubmit = () => { usage_disk, temperature, usage_temperature, + selectedDisks, ...rest } = form; @@ -68,6 +69,7 @@ const useInfrastructureSubmit = () => { description: form.name, type: "hardware", notifications: infrastructureMonitor.notifications, + selectedDisks, thresholds, }; // Handle create or update diff --git a/client/src/Pages/v1/Infrastructure/Create/index.jsx b/client/src/Pages/v1/Infrastructure/Create/index.jsx index d4fd859ec..b02cd36cc 100644 --- a/client/src/Pages/v1/Infrastructure/Create/index.jsx +++ b/client/src/Pages/v1/Infrastructure/Create/index.jsx @@ -10,9 +10,11 @@ import { HttpAdornment } from "@/Components/v1/Inputs/TextInput/Adornments/index import MonitorStatusHeader from "./Components/MonitorStatusHeader.jsx"; import MonitorActionButtons from "./Components/MonitorActionButtons.jsx"; import CustomAlertsSection from "./Components/CustomAlertsSection.jsx"; +import DiskSelection from "./Components/DiskSelection.jsx"; // Utils import NotificationsConfig from "@/Components/v1/NotificationConfig/index.jsx"; import { useGetNotificationsByTeamId } from "../../../../Hooks/v1/useNotifications.js"; +import { networkService } from "../../../../Utils/NetworkService"; import { useParams } from "react-router-dom"; import { useState, useEffect } from "react"; import { useTheme } from "@emotion/react"; @@ -37,6 +39,7 @@ const CreateInfrastructureMonitor = () => { // State const [https, setHttps] = useState(false); const [updateTrigger, setUpdateTrigger] = useState(false); + const [availableDisks, setAvailableDisks] = useState([]); // Fetch monitor details if editing const [monitor, isLoading] = useFetchHardwareMonitorById({ @@ -72,9 +75,9 @@ const CreateInfrastructureMonitor = () => { ...(isCreate ? [{ name: "Create", path: "/infrastructure/create" }] : [ - { name: "Details", path: `/infrastructure/${monitorId}` }, - { name: "Configure", path: `/infrastructure/configure/${monitorId}` }, - ]), + { name: "Details", path: `/infrastructure/${monitorId}` }, + { name: "Configure", path: `/infrastructure/configure/${monitorId}` }, + ]), ]; // Populate form fields if editing useEffect(() => { @@ -85,6 +88,31 @@ const CreateInfrastructureMonitor = () => { } else if (monitor) { setHttps(monitor.url.startsWith("https")); initializeInfrastructureMonitorForUpdate(monitor); + const fetchLastCheck = async () => { + try { + const { stats } = monitor ?? {}; + let latestCheck = stats?.aggregateData?.latestCheck; + let disks = latestCheck?.disk || []; + + if (disks.length > 0) { + setAvailableDisks(disks); + return; + } + + const response = await networkService.getChecksByMonitor({ + monitorId, + dateRange: "all", + rowsPerPage: 1, + sortOrder: "desc", + }); + disks = response?.data?.data?.checks?.[0]?.disk || []; + setAvailableDisks(disks); + } catch (error) { + setAvailableDisks([]); + } + }; + + fetchLastCheck(); } }, [ isCreate, @@ -133,6 +161,8 @@ const CreateInfrastructureMonitor = () => { isPausing || notificationsAreLoading; + + return ( @@ -327,6 +357,17 @@ const CreateInfrastructureMonitor = () => { infrastructureMonitor={infrastructureMonitor} handleCheckboxChange={handleCheckboxChange} /> + + {monitorId && ( + + onChangeForm("selectedDisks", newSelectedDisks) + } + /> + )} + { +const Gauge = ({ value, heading, metricOne, valueOne, metricTwo, valueTwo, + metricThree, valueThree, metricFour, valueFour }) => { const theme = useTheme(); const valueStyle = { @@ -70,6 +71,24 @@ const Gauge = ({ value, heading, metricOne, valueOne, metricTwo, valueTwo }) => {metricTwo} {valueTwo} + + {metricThree} + {valueThree} + + + {metricFour} + {valueFour} + @@ -83,6 +102,10 @@ Gauge.propTypes = { valueOne: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), metricTwo: PropTypes.string, valueTwo: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), + metricThree: PropTypes.string, + valueThree: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), + metricFour: PropTypes.string, + valueFour: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), }; export default Gauge; diff --git a/client/src/Pages/v1/Infrastructure/Details/Components/GaugeBoxes/index.jsx b/client/src/Pages/v1/Infrastructure/Details/Components/GaugeBoxes/index.jsx index 432881e7e..91bb9e2f0 100644 --- a/client/src/Pages/v1/Infrastructure/Details/Components/GaugeBoxes/index.jsx +++ b/client/src/Pages/v1/Infrastructure/Details/Components/GaugeBoxes/index.jsx @@ -10,7 +10,7 @@ import { useTheme } from "@emotion/react"; import { useTranslation } from "react-i18next"; const Gauges = ({ isLoading = false, monitor }) => { - const { decimalToPercentage, formatBytes } = useHardwareUtils(); + const { decimalToPercentage, formatBytes, formatDeviceName, formatMountpoint } = useHardwareUtils(); const theme = useTheme(); const { t } = useTranslation(); @@ -46,16 +46,27 @@ const Gauges = ({ isLoading = false, monitor }) => { metricTwo: t("frequency"), valueTwo: `${(cpuFrequency / 1000).toFixed(2)} Ghz`, }, - ...(latestCheck?.disk ?? []).map((disk, idx) => ({ - type: "disk", - diskIndex: idx, - value: decimalToPercentage(disk.usage_percent), - heading: `Disk${idx} usage`, - metricOne: t("used"), - valueOne: formatBytes(disk.total_bytes - disk.free_bytes, true), - metricTwo: t("total"), - valueTwo: formatBytes(disk.total_bytes, true), - })), + ...(latestCheck?.disk ?? []) + .filter((disk) => { + if (!monitor?.selectedDisks || monitor.selectedDisks.length === 0) { + return true; + } + return monitor.selectedDisks.includes(disk.mountpoint || disk.device); + }) + .map((disk, idx) => ({ + type: "disk", + diskIndex: idx, + value: decimalToPercentage(disk.usage_percent), + heading: `Disk${idx} usage`, + metricOne: t("used"), + valueOne: formatBytes(disk.total_bytes - disk.free_bytes, true), + metricTwo: t("total"), + valueTwo: formatBytes(disk.total_bytes, true), + metricThree: t("device"), + valueThree: formatDeviceName(disk.device), + metricFour: t("mountpoint"), + valueFour: formatMountpoint(disk.mountpoint), + })), ]; return ( @@ -74,6 +85,10 @@ const Gauges = ({ isLoading = false, monitor }) => { valueOne={gauge.valueOne} metricTwo={gauge.metricTwo} valueTwo={gauge.valueTwo} + metricThree={gauge.metricThree} + valueThree={gauge.valueThree} + metricFour={gauge.metricFour} + valueFour={gauge.valueFour} /> ); })} diff --git a/client/src/Pages/v1/Infrastructure/Details/Hooks/useHardwareUtils.jsx b/client/src/Pages/v1/Infrastructure/Details/Hooks/useHardwareUtils.jsx index 8edb6fb87..80efb21b9 100644 --- a/client/src/Pages/v1/Infrastructure/Details/Hooks/useHardwareUtils.jsx +++ b/client/src/Pages/v1/Infrastructure/Details/Hooks/useHardwareUtils.jsx @@ -1,4 +1,4 @@ -import { Typography } from "@mui/material"; +import { Typography, Tooltip } from "@mui/material"; import { useTheme } from "@emotion/react"; import { useTranslation } from "react-i18next"; @@ -120,6 +120,87 @@ const useHardwareUtils = () => { } }; + const formatDeviceName = (device) => { + const deviceStr = String(device || ''); + + // Extract the last part of the path (after last '/') + const parts = deviceStr.split('/'); + const lastPart = parts[parts.length - 1]; + + // If there's more than one part, show with "..." prefix + const displayText = parts.length > 1 ? `.../${lastPart}` : deviceStr; + + // Always show tooltip with full device path + return ( + + + {displayText} + + + ); + }; + + const formatMountpoint = (mountpoint) => { + const mountpointStr = String(mountpoint || ''); + + if (!mountpointStr) { + return ( + + + N/A + + + ); + } + + // Extract the last part of the path (after last '/') + const parts = mountpointStr.split('/'); + const lastPart = parts[parts.length - 1]; + + // If there's more than one part, show with "..." prefix + const displayText = parts.length > 1 ? `.../${lastPart}` : mountpointStr; + + // Always show tooltip with full mountpoint path + return ( + + + {displayText} + + + ); + } + /** * Converts a decimal value to a percentage * @@ -178,6 +259,8 @@ const useHardwareUtils = () => { return { formatBytes, + formatDeviceName, + formatMountpoint, decimalToPercentage, buildTemps, getDimensions, diff --git a/client/src/Validation/validation.js b/client/src/Validation/validation.js index ce50d96c1..dfd5639ce 100644 --- a/client/src/Validation/validation.js +++ b/client/src/Validation/validation.js @@ -144,44 +144,44 @@ const monitorValidation = joi.object({ // Regex from https://gist.github.com/dperini/729294 var urlRegex = new RegExp( "^" + - // protocol identifier (optional) - // short syntax // still required - "(?:(?:https?|ftp):\\/\\/)?" + - // user:pass BasicAuth (optional) - "(?:" + - // IP address dotted notation octets - // excludes loopback network 0.0.0.0 - // excludes reserved space >= 224.0.0.0 - // excludes network & broadcast addresses - // (first & last IP address of each class) - "(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])" + - "(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}" + - "(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))" + - "|" + - // host & domain names, may end with dot - // can be replaced by a shortest alternative - // (?![-_])(?:[-\\w\\u00a1-\\uffff]{0,63}[^-_]\\.)+ - "(?:" + - // Single hostname without dots (like localhost) - "[a-z0-9\\u00a1-\\uffff][a-z0-9\\u00a1-\\uffff_-]{0,62}" + - "|" + - // Domain with dots - "(?:" + - "(?:" + - "[a-z0-9\\u00a1-\\uffff]" + - "[a-z0-9\\u00a1-\\uffff_-]{0,62}" + - ")?" + - "[a-z0-9\\u00a1-\\uffff]\\." + - ")+" + - // TLD identifier name, may end with dot - "(?:[a-z\\u00a1-\\uffff]{2,}\\.?)" + - ")" + - ")" + - // port number (optional) - "(?::\\d{2,5})?" + - // resource path (optional) - "(?:[/?#]\\S*)?" + - "$", + // protocol identifier (optional) + // short syntax // still required + "(?:(?:https?|ftp):\\/\\/)?" + + // user:pass BasicAuth (optional) + "(?:" + + // IP address dotted notation octets + // excludes loopback network 0.0.0.0 + // excludes reserved space >= 224.0.0.0 + // excludes network & broadcast addresses + // (first & last IP address of each class) + "(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])" + + "(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}" + + "(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))" + + "|" + + // host & domain names, may end with dot + // can be replaced by a shortest alternative + // (?![-_])(?:[-\\w\\u00a1-\\uffff]{0,63}[^-_]\\.)+ + "(?:" + + // Single hostname without dots (like localhost) + "[a-z0-9\\u00a1-\\uffff][a-z0-9\\u00a1-\\uffff_-]{0,62}" + + "|" + + // Domain with dots + "(?:" + + "(?:" + + "[a-z0-9\\u00a1-\\uffff]" + + "[a-z0-9\\u00a1-\\uffff_-]{0,62}" + + ")?" + + "[a-z0-9\\u00a1-\\uffff]\\." + + ")+" + + // TLD identifier name, may end with dot + "(?:[a-z\\u00a1-\\uffff]{2,}\\.?)" + + ")" + + ")" + + // port number (optional) + "(?::\\d{2,5})?" + + // resource path (optional) + "(?:[/?#]\\S*)?" + + "$", "i" ); if (!urlRegex.test(value)) { @@ -448,6 +448,7 @@ const infrastructureMonitorValidation = joi.object({ "number.max": "Status window threshold cannot exceed 100%.", }), notifications: joi.array().items(joi.string()), + selectedDisks: joi.array().items(joi.string()).optional(), }); const notificationValidation = joi.object({ diff --git a/client/src/locales/de.json b/client/src/locales/de.json index da5a3ee61..fd3918378 100644 --- a/client/src/locales/de.json +++ b/client/src/locales/de.json @@ -1129,5 +1129,12 @@ "packetsReceivedRate": "Rate empfangener Pakete", "packetsSent": "Gesendete Pakete", "rate": "Rate", - "selectInterface": "Schnittstelle auswählen" + "selectInterface": "Schnittstelle auswählen", + "v1": { + "infrastructure": { + "disk_selection_title": "Festplattenauswahl", + "disk_selection_info": "Momentan wurde keine Festplatte erkannt.", + "disk_selection_description": "Wählen Sie die spezifischen Festplatten aus, die Sie überwachen möchten." + } + } } diff --git a/client/src/locales/en.json b/client/src/locales/en.json index 79834584d..9568671c2 100644 --- a/client/src/locales/en.json +++ b/client/src/locales/en.json @@ -1142,6 +1142,12 @@ "packetsSent": "Packets Sent", "rate": "Rate", "selectInterface": "Select Interface", + "v1": { + "infrastructure": { + "disk_selection_title": "Disk Selection", + "disk_selection_info": "No disk detected for the moment.", + "disk_selection_description": "Select the specific disks you want to monitor." + } "incidentsPage": { "title": "Incidents", "description": "Manage incidents for your monitors. You can resolve incidents here.", diff --git a/client/src/locales/fr.json b/client/src/locales/fr.json index 1ebc8bad4..9e76440f0 100644 --- a/client/src/locales/fr.json +++ b/client/src/locales/fr.json @@ -1129,5 +1129,12 @@ "packetsReceivedRate": "", "packetsSent": "", "rate": "", - "selectInterface": "" + "selectInterface": "", + "v1": { + "infrastructure": { + "disk_selection_title": "Sélection des disques", + "disk_selection_info": "Aucun disque détecté pour le moment.", + "disk_selection_description": "Sélectionnez les disques spécifiques que vous souhaitez surveiller." + } + } } diff --git a/client/src/locales/ja.json b/client/src/locales/ja.json index f458b8ed0..68d94139f 100644 --- a/client/src/locales/ja.json +++ b/client/src/locales/ja.json @@ -1108,5 +1108,12 @@ "packetsReceivedRate": "", "packetsSent": "", "rate": "", - "selectInterface": "" + "selectInterface": "", + "v1": { + "infrastructure": { + "disk_selection_title": "ディスク選択", + "disk_selection_info": "現在ディスクが検出されていません。", + "disk_selection_description": "監視したい特定のディスクを選択してください。" + } + } } diff --git a/client/src/locales/pt-BR.json b/client/src/locales/pt-BR.json index 1a6d9a62f..193c53788 100644 --- a/client/src/locales/pt-BR.json +++ b/client/src/locales/pt-BR.json @@ -1129,5 +1129,12 @@ "packetsReceivedRate": "", "packetsSent": "", "rate": "", - "selectInterface": "" + "selectInterface": "", + "v1": { + "infrastructure": { + "disk_selection_title": "Seleção de Discos", + "disk_selection_info": "Nenhum disco detectado no momento.", + "disk_selection_description": "Selecione os discos específicos que você deseja monitorar." + } + } } diff --git a/client/src/locales/ru.json b/client/src/locales/ru.json index cdb4d235d..ab40ecb0d 100644 --- a/client/src/locales/ru.json +++ b/client/src/locales/ru.json @@ -1129,5 +1129,12 @@ "packetsReceivedRate": "Скорость получения пакетов", "packetsSent": "Отправлено пакетов", "rate": "коэффициент", - "selectInterface": "Выберите интерфейс" + "selectInterface": "Выберите интерфейс", + "v1": { + "infrastructure": { + "disk_selection_title": "Выбор дисков", + "disk_selection_info": "На данный момент диск не обнаружен.", + "disk_selection_description": "Выберите конкретные диски, которые вы хотите отслеживать." + } + } } diff --git a/client/src/locales/th.json b/client/src/locales/th.json index c32849afe..d5f9ad137 100644 --- a/client/src/locales/th.json +++ b/client/src/locales/th.json @@ -1129,5 +1129,12 @@ "packetsReceivedRate": "อัตราการรับแพ็กเก็ต", "packetsSent": "แพ็กเก็ตที่ส่ง", "rate": "อัตรา", - "selectInterface": "เลือกอินเทอร์เฟซ" + "selectInterface": "เลือกอินเทอร์เฟซ", + "v1": { + "infrastructure": { + "disk_selection_title": "การเลือกดิสก์", + "disk_selection_info": "ไม่พบดิสก์ในขณะนี้", + "disk_selection_description": "เลือกดิสก์ที่คุณต้องการตรวจสอบ" + } + } } diff --git a/client/src/locales/zh-CN.json b/client/src/locales/zh-CN.json index 305cefe87..67b419445 100644 --- a/client/src/locales/zh-CN.json +++ b/client/src/locales/zh-CN.json @@ -1121,5 +1121,12 @@ "packetsReceivedRate": "数据包接收率", "packetsSent": "已发送数据包", "rate": "速度", - "selectInterface": "选择接口" + "selectInterface": "选择接口", + "v1": { + "infrastructure": { + "disk_selection_title": "磁盘选择", + "disk_selection_info": "目前没有检测到磁盘。", + "disk_selection_description": "选择您要监控的特定磁盘。" + } + } } diff --git a/client/vite.config.ts b/client/vite.config.ts index 5a6b428c7..65a07ad5c 100644 --- a/client/vite.config.ts +++ b/client/vite.config.ts @@ -12,6 +12,9 @@ export default defineConfig(({}) => { return { base: "/", plugins: [svgr(), react()], + server: { + host: true, + }, resolve: { alias: { "@": path.resolve(__dirname, "src"), diff --git a/docs/infrastructure-disk-selection.md b/docs/infrastructure-disk-selection.md new file mode 100644 index 000000000..500e3be1e --- /dev/null +++ b/docs/infrastructure-disk-selection.md @@ -0,0 +1,74 @@ +# Infrastructure Monitoring - Disk Selection + +This guide explains how to use the selective disk monitoring feature in Checkmate's infrastructure monitoring. + +## Overview + +By default, Checkmate monitors all detected disks on your server. The disk selection feature allows you to choose specific disks/mountpoints to monitor, giving you more control over what gets tracked and displayed. + +## Prerequisites + +- Checkmate server running with [Capture agent](https://github.com/bluewave-labs/capture) installed on target server +- An existing infrastructure monitor already created and configured +- At least one disk detected by the Capture agent + +## Using Disk Selection + +### Accessing the Feature + +1. Navigate to your Infrastructure monitors page +2. Click on an existing infrastructure monitor to view details +3. Click the "Configure" or "Edit" button +4. Scroll down to the **Disk Selection** section + +> **Note:** The disk selection feature is only available when editing existing monitors that have already detected disks. + +### Selecting Disks to Monitor + +1. **View Available Disks**: The system automatically detects all disks/mountpoints from your server +2. **Select Disks**: Check the boxes next to the disks you want to monitor +3. **Apply Changes**: Click "Save" to update your monitor configuration + +### Understanding Disk Identifiers + +Disks are identified by their mountpoint or device name: +- **Mountpoint**: `/` (root), `/home`, `/var`, etc. +- **Device**: `/dev/sda1`, `/dev/nvme0n1p1`, etc. + +### Behavior + +- **All disks selected**: Shows all detected disks in gauges and charts +- **Specific disks selected**: Only shows selected disks in the monitoring interface +- **No disks detected**: Displays "No disk detected for the moment" message + +## What Gets Filtered + +When you select specific disks, the following elements are filtered: + +- **Disk Usage Gauges**: Only selected disks appear in the dashboard +- **Disk Usage Charts**: Time-series charts show only selected disks +- **Monitor Table**: Summary view reflects only selected disk usage + +## Example Use Cases + +- **Server with multiple drives**: Monitor only critical system disks, ignore temporary storage +- **Database servers**: Focus monitoring on database partition while ignoring logs partition +- **Web servers**: Monitor web content disk separately from system disk +- **Development environments**: Track only project-specific mountpoints + +## Troubleshooting + +### No Disks Appearing +- Verify the Capture agent is running on the target server +- Check that the agent has proper permissions to read disk information +- Ensure the monitor has been running long enough to collect at least one check + +### Missing Disk Information +- Some disks may not be accessible to the Capture agent due to permissions +- Virtual or network-mounted disks may not appear in the list +- Check the Capture agent logs for any disk detection errors + +## Related Documentation + +- [Infrastructure Monitoring Setup](https://docs.checkmate.so/checkmate-2.1) +- [Capture Agent Installation](https://github.com/bluewave-labs/capture) \ No newline at end of file diff --git a/server/src/db/v1/models/Check.js b/server/src/db/v1/models/Check.js index 789cebaa5..7a5117979 100755 --- a/server/src/db/v1/models/Check.js +++ b/server/src/db/v1/models/Check.js @@ -17,6 +17,8 @@ const memorySchema = mongoose.Schema({ }); const diskSchema = mongoose.Schema({ + device: { type: String, default: "" }, + mountpoint: { type: String, default: "" }, read_speed_bytes: { type: Number, default: 0 }, write_speed_bytes: { type: Number, default: 0 }, total_bytes: { type: Number, default: 0 }, diff --git a/server/src/db/v1/models/Monitor.js b/server/src/db/v1/models/Monitor.js index e6e1a0024..901dc39d1 100755 --- a/server/src/db/v1/models/Monitor.js +++ b/server/src/db/v1/models/Monitor.js @@ -125,6 +125,10 @@ const MonitorSchema = mongoose.Schema( return this.alertThreshold; }, }, + selectedDisks: { + type: [String], + default: [], + }, gameId: { type: String, }, diff --git a/server/src/validation/joi.js b/server/src/validation/joi.js index bc88d4567..b3342de83 100755 --- a/server/src/validation/joi.js +++ b/server/src/validation/joi.js @@ -174,6 +174,7 @@ const createMonitorBodyValidation = joi.object({ expectedValue: joi.string().allow(""), matchMethod: joi.string(), gameId: joi.string().allow(""), + selectedDisks: joi.array().items(joi.string()).optional(), group: joi.string().max(50).trim().allow(null, "").optional(), }); @@ -204,6 +205,7 @@ const editMonitorBodyValidation = joi.object({ usage_temperature: joi.number(), }), gameId: joi.string(), + selectedDisks: joi.array().items(joi.string()).optional(), group: joi.string().max(50).trim().allow(null, "").optional(), });