amd-node-scraper 0.0.1__py3-none-any.whl

nodescraper/plugins/inband/fabrics/fabrics_plugin.py

@@ -0,0 +1,37 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from nodescraper.base import InBandDataPlugin
+
+from .fabrics_collector import FabricsCollector
+from .fabricsdata import FabricsDataModel
+
+
+class FabricsPlugin(InBandDataPlugin[FabricsDataModel, None, None]):
+    """Plugin for collection of InfiniBand/RDMA fabrics configuration data"""
+
+    DATA_MODEL = FabricsDataModel
+
+    COLLECTOR = FabricsCollector

nodescraper/plugins/inband/fabrics/fabricsdata.py

@@ -0,0 +1,140 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from typing import Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+from nodescraper.models import DataModel
+
+
+class IbstatDevice(BaseModel):
+    """InfiniBand device information from ibstat"""
+
+    ca_name: Optional[str] = None  # CA name (e.g., "mlx5_0")
+    ca_type: Optional[str] = None  # CA type
+    number_of_ports: Optional[int] = None  # Number of physical ports
+    firmware_version: Optional[str] = None  # Firmware version
+    hardware_version: Optional[str] = None  # Hardware version
+    node_guid: Optional[str] = None  # Node GUID
+    system_image_guid: Optional[str] = None  # System image GUID
+    ports: Dict[int, Dict[str, str]] = Field(default_factory=dict)  # Port number -> port attributes
+    raw_output: str = ""  # Raw command output
+
+
+class IbvDeviceInfo(BaseModel):
+    """InfiniBand verbs device information from ibv_devinfo"""
+
+    device: Optional[str] = None  # Device name (e.g., "mlx5_0")
+    node_guid: Optional[str] = None  # Node GUID
+    sys_image_guid: Optional[str] = None  # System image GUID
+    vendor_id: Optional[str] = None  # Vendor ID
+    vendor_part_id: Optional[str] = None  # Vendor part ID
+    hw_ver: Optional[str] = None  # Hardware version
+    fw_ver: Optional[str] = None  # Firmware version
+    node_type: Optional[str] = None  # Node type
+    transport_type: Optional[str] = None  # Transport type (e.g., "InfiniBand", "Ethernet")
+    ports: Dict[int, Dict[str, str]] = Field(default_factory=dict)  # Port number -> port attributes
+    raw_output: str = ""  # Raw command output
+
+
+class IbdevNetdevMapping(BaseModel):
+    """Mapping between IB device and network interface"""
+
+    ib_device: str  # InfiniBand device name (e.g., "mlx5_0")
+    port: int  # Port number
+    netdev: Optional[str] = None  # Network device name (e.g., "ib0", "eth0")
+    state: Optional[str] = None  # Port state (e.g., "Up", "Down")
+    pkey: Optional[str] = None  # Partition key
+    guid: Optional[str] = None  # GUID
+
+
+class OfedInfo(BaseModel):
+    """OFED version and information"""
+
+    version: Optional[str] = None  # OFED version
+    raw_output: str = ""  # Raw command output
+
+
+class MstDevice(BaseModel):
+    """Mellanox Software Tools device information"""
+
+    device: str  # Device path (e.g., "/dev/mst/mt4123_pciconf0")
+    pci_address: Optional[str] = None  # PCI address
+    rdma_device: Optional[str] = None  # RDMA device name
+    net_device: Optional[str] = None  # Network device name
+    attributes: Dict[str, str] = Field(default_factory=dict)  # Additional attributes
+
+
+class MstStatus(BaseModel):
+    """Mellanox Software Tools status"""
+
+    mst_started: bool = False  # Whether MST service is started
+    devices: List[MstDevice] = Field(default_factory=list)  # List of MST devices
+    raw_output: str = ""  # Raw command output
+
+
+class RdmaDevice(BaseModel):
+    """RDMA device information from rdma command"""
+
+    device: str  # Device name (e.g., "mlx5_0")
+    node_type: Optional[str] = None  # Node type
+    transport: Optional[str] = None  # Transport type
+    node_guid: Optional[str] = None  # Node GUID
+    sys_image_guid: Optional[str] = None  # System image GUID
+    state: Optional[str] = None  # Device state
+    attributes: Dict[str, str] = Field(default_factory=dict)  # Additional attributes
+
+
+class RdmaLink(BaseModel):
+    """RDMA link information"""
+
+    device: str  # Device name
+    port: int  # Port number
+    state: Optional[str] = None  # Link state
+    physical_state: Optional[str] = None  # Physical state
+    netdev: Optional[str] = None  # Associated network device
+    attributes: Dict[str, str] = Field(default_factory=dict)  # Additional attributes
+
+
+class RdmaInfo(BaseModel):
+    """Complete RDMA information from rdma command"""
+
+    devices: List[RdmaDevice] = Field(default_factory=list)  # RDMA devices
+    links: List[RdmaLink] = Field(default_factory=list)  # RDMA links
+    raw_output: str = ""  # Raw command output
+
+
+class FabricsDataModel(DataModel):
+    """Complete InfiniBand/RDMA fabrics configuration data"""
+
+    ibstat_devices: List[IbstatDevice] = Field(default_factory=list)  # ibstat output
+    ibv_devices: List[IbvDeviceInfo] = Field(default_factory=list)  # ibv_devinfo output
+    ibdev_netdev_mappings: List[IbdevNetdevMapping] = Field(
+        default_factory=list
+    )  # ibdev2netdev output
+    ofed_info: Optional[OfedInfo] = None  # OFED version info
+    mst_status: Optional[MstStatus] = None  # MST status
+    rdma_info: Optional[RdmaInfo] = None  # RDMA information

nodescraper/plugins/inband/journal/__init__.py

@@ -0,0 +1,28 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from .journal_plugin import JournalPlugin
+
+__all__ = ["JournalPlugin"]

nodescraper/plugins/inband/journal/collector_args.py

@@ -0,0 +1,33 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+
+from typing import Optional
+
+from nodescraper.models import CollectorArgs
+
+
+class JournalCollectorArgs(CollectorArgs):
+    boot: Optional[int] = None

nodescraper/plugins/inband/journal/journal_collector.py

@@ -0,0 +1,107 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from typing import Optional
+
+from pydantic import ValidationError
+
+from nodescraper.base import InBandDataCollector
+from nodescraper.enums import EventCategory, EventPriority, ExecutionStatus, OSFamily
+from nodescraper.models import TaskResult
+from nodescraper.utils import get_exception_details
+
+from .collector_args import JournalCollectorArgs
+from .journaldata import JournalData
+
+
+class JournalCollector(InBandDataCollector[JournalData, JournalCollectorArgs]):
+    """Read journal log via journalctl."""
+
+    SUPPORTED_OS_FAMILY = {OSFamily.LINUX}
+    DATA_MODEL = JournalData
+    CMD = "journalctl --no-pager --system --output=short-iso"
+
+    def _read_with_journalctl(self, args: Optional[JournalCollectorArgs] = None):
+        """Read journal logs using journalctl
+
+        Returns:
+            str|None: system journal read
+        """
+
+        cmd = "journalctl --no-pager --system --output=short-iso"
+        try:
+            # safe check for args.boot
+            if args is not None and getattr(args, "boot", None):
+                cmd = f"journalctl --no-pager -b {args.boot} --system --output=short-iso"
+
+            res = self._run_sut_cmd(cmd, sudo=True, log_artifact=False, strip=False)
+
+        except ValidationError as val_err:
+            self._log_event(
+                category=EventCategory.OS,
+                description="Exception while running journalctl",
+                data=get_exception_details(val_err),
+                priority=EventPriority.ERROR,
+                console_log=True,
+            )
+            self.result.message = "Could not read journalctl data"
+            self.result.status = ExecutionStatus.ERROR
+            return None
+
+        if res.exit_code != 0:
+            self._log_event(
+                category=EventCategory.OS,
+                description="Error reading journalctl",
+                data={"command": res.command, "exit_code": res.exit_code},
+                priority=EventPriority.ERROR,
+                console_log=True,
+            )
+            self.result.message = "Could not read journalctl data"
+            self.result.status = ExecutionStatus.ERROR
+            return None
+
+        return res.stdout
+
+    def collect_data(
+        self,
+        args: Optional[JournalCollectorArgs] = None,
+    ) -> tuple[TaskResult, Optional[JournalData]]:
+        """Collect journal logs
+
+        Args:
+            args (_type_, optional): Collection args. Defaults to None.
+
+        Returns:
+            tuple[TaskResult, Optional[JournalData]]: Tuple of results and data model or none.
+        """
+        if args is None:
+            args = JournalCollectorArgs()
+
+        journal_log = self._read_with_journalctl(args)
+        if journal_log:
+            data = JournalData(journal_log=journal_log)
+            self.result.message = self.result.message or "Journal data collected"
+            return self.result, data
+        return self.result, None

nodescraper/plugins/inband/journal/journal_plugin.py

@@ -0,0 +1,40 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from nodescraper.base import InBandDataPlugin
+
+from .collector_args import JournalCollectorArgs
+from .journal_collector import JournalCollector
+from .journaldata import JournalData
+
+
+class JournalPlugin(InBandDataPlugin[JournalData, JournalCollectorArgs, None]):
+    """Plugin for collection of journal data"""
+
+    DATA_MODEL = JournalData
+
+    COLLECTOR = JournalCollector
+
+    COLLECTOR_ARGS = JournalCollectorArgs

nodescraper/plugins/inband/journal/journaldata.py

@@ -0,0 +1,44 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+import os
+
+from nodescraper.models import DataModel
+
+
+class JournalData(DataModel):
+    """Data model for journal logs"""
+
+    journal_log: str
+
+    def log_model(self, log_path: str):
+        """Log data model to a file
+
+        Args:
+            log_path (str): log path
+        """
+        log_name = os.path.join(log_path, "journal.log")
+        with open(log_name, "w", encoding="utf-8") as log_filename:
+            log_filename.write(self.journal_log)

nodescraper/plugins/inband/kernel/__init__.py

@@ -0,0 +1,25 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################

nodescraper/plugins/inband/kernel/analyzer_args.py

@@ -0,0 +1,64 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from typing import Union
+
+from pydantic import Field, field_validator
+
+from nodescraper.models import AnalyzerArgs
+from nodescraper.plugins.inband.kernel.kerneldata import KernelDataModel
+
+
+class KernelAnalyzerArgs(AnalyzerArgs):
+    exp_kernel: Union[str, list] = Field(default_factory=list)
+    regex_match: bool = False
+
+    @field_validator("exp_kernel", mode="before")
+    @classmethod
+    def validate_exp_kernel(cls, exp_kernel: Union[str, list]) -> list:
+        """support str or list input for exp_kernel
+
+        Args:
+            exp_kernel (Union[str, list]): exp kernel input
+
+        Returns:
+            list: exp kernel list
+        """
+        if isinstance(exp_kernel, str):
+            exp_kernel = [exp_kernel]
+
+        return exp_kernel
+
+    @classmethod
+    def build_from_model(cls, datamodel: KernelDataModel) -> "KernelAnalyzerArgs":
+        """build analyzer args from data model
+
+        Args:
+            datamodel (KernelDataModel): data model for plugin
+
+        Returns:
+            KernelAnalyzerArgs: instance of analyzer args class
+        """
+        return cls(exp_kernel=datamodel.kernel_version)

nodescraper/plugins/inband/kernel/kernel_analyzer.py

@@ -0,0 +1,91 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+import re
+from typing import Optional
+
+from nodescraper.enums import EventCategory, EventPriority, ExecutionStatus
+from nodescraper.interfaces import DataAnalyzer
+from nodescraper.models import TaskResult
+
+from .analyzer_args import KernelAnalyzerArgs
+from .kerneldata import KernelDataModel
+
+
+class KernelAnalyzer(DataAnalyzer[KernelDataModel, KernelAnalyzerArgs]):
+    """Check kernel matches expected versions"""
+
+    DATA_MODEL = KernelDataModel
+
+    def analyze_data(
+        self, data: KernelDataModel, args: Optional[KernelAnalyzerArgs] = None
+    ) -> TaskResult:
+        """Analyze the kernel data against expected versions.
+
+        Args:
+            data (KernelDataModel): Kernel data to analyze.
+            args (Optional[KernelAnalyzerArgs], optional): Kernel analysis arguments. Defaults to None.
+
+        Returns:
+            TaskResult: Result of the analysis containing status and message.
+        """
+        if not args:
+            self.result.message = "Expected kernel not provided"
+            self.result.status = ExecutionStatus.NOT_RAN
+            return self.result
+
+        for kernel in args.exp_kernel:
+            if args.regex_match:
+                try:
+                    regex_data = re.compile(kernel)
+                except re.error:
+                    self._log_event(
+                        category=EventCategory.RUNTIME,
+                        description="Kernel regex is invalid",
+                        data={"regex": kernel},
+                        priority=EventPriority.ERROR,
+                    )
+                    continue
+                if regex_data.match(data.kernel_version):
+                    self.result.message = "Kernel matches expected"
+                    self.result.status = ExecutionStatus.OK
+                    return self.result
+            elif data.kernel_version == kernel:
+                self.result.message = "Kernel matches expected"
+                self.result.status = ExecutionStatus.OK
+                return self.result
+
+        self.result.message = (
+            f"Kernel mismatch! Expected: {args.exp_kernel}, actual: {data.kernel_version}"
+        )
+        self.result.status = ExecutionStatus.ERROR
+        self._log_event(
+            category=EventCategory.OS,
+            description=f"{self.result.message}",
+            data={"expected": args.exp_kernel, "actual": data.kernel_version},
+            priority=EventPriority.CRITICAL,
+            console_log=True,
+        )
+        return self.result