Skip to content

Commit 882bfd5

Browse files
committed
added script to generate docsa
1 parent b3e3791 commit 882bfd5

File tree

2 files changed

+521
-57
lines changed

2 files changed

+521
-57
lines changed

docs/PLUGIN_DOC.md

Lines changed: 38 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
| nodescraper.plugins.inband.kernel.kernel_plugin.KernelPlugin | [KernelDataModel](#KernelDataModel-Model) | [KernelCollector](#Collector-Class-KernelCollector) | [KernelAnalyzer](#Data-Analyzer-Class-KernelAnalyzer) | KernelAnalyzerArgs | sh -c 'uname -r'<br>wmic os get Version /Value |
1414
| nodescraper.plugins.inband.kernel_module.kernel_module_plugin.KernelModulePlugin | [KernelModuleDataModel](#KernelModuleDataModel-Model) | [KernelModuleCollector](#Collector-Class-KernelModuleCollector) | [KernelModuleAnalyzer](#Data-Analyzer-Class-KernelModuleAnalyzer) | KernelModuleAnalyzerArgs | cat /proc/modules<br>wmic os get Version /Value |
1515
| nodescraper.plugins.inband.memory.memory_plugin.MemoryPlugin | [MemoryDataModel](#MemoryDataModel-Model) | [MemoryCollector](#Collector-Class-MemoryCollector) | [MemoryAnalyzer](#Data-Analyzer-Class-MemoryAnalyzer) | - | free -b<br>wmic OS get FreePhysicalMemory /Value; wmic ComputerSystem get TotalPhysicalMemory /Value |
16-
| nodescraper.plugins.inband.nvme.nvme_plugin.NvmePlugin | [NvmeDataModel](#NvmeDataModel-Model) | [NvmeCollector](#Collector-Class-NvmeCollector) | - | - | - |
16+
| nodescraper.plugins.inband.nvme.nvme_plugin.NvmePlugin | [NvmeDataModel](#NvmeDataModel-Model) | [NvmeCollector](#Collector-Class-NvmeCollector) | - | - | nvme smart-log {dev}<br>nvme error-log {dev} --log-entries=256<br>nvme id-ctrl {dev}<br>nvme id-ns {dev}{ns}<br>nvme fw-log {dev}<br>nvme self-test-log {dev}<br>nvme get-log {dev} --log-id=6 --log-len=512<br>nvme telemetry-log {dev} --output-file={dev}_{f_name} |
1717
| nodescraper.plugins.inband.os.os_plugin.OsPlugin | [OsDataModel](#OsDataModel-Model) | [OsCollector](#Collector-Class-OsCollector) | [OsAnalyzer](#Data-Analyzer-Class-OsAnalyzer) | OsAnalyzerArgs | sh -c '( lsb_release -ds || (cat /etc/*release | grep PRETTY_NAME) || uname -om ) 2>/dev/null | head -n1'<br>cat /etc/*release | grep VERSION_ID<br>wmic os get Version /value<br>wmic os get Caption /Value |
1818
| nodescraper.plugins.inband.package.package_plugin.PackagePlugin | [PackageDataModel](#PackageDataModel-Model) | [PackageCollector](#Collector-Class-PackageCollector) | [PackageAnalyzer](#Data-Analyzer-Class-PackageAnalyzer) | PackageAnalyzerArgs | dnf list --installed<br>dpkg-query -W<br>pacman -Q<br>cat /etc/*release<br>wmic product get name,version |
1919
| nodescraper.plugins.inband.process.process_plugin.ProcessPlugin | [ProcessDataModel](#ProcessDataModel-Model) | [ProcessCollector](#Collector-Class-ProcessCollector) | [ProcessAnalyzer](#Data-Analyzer-Class-ProcessAnalyzer) | ProcessAnalyzerArgs | top -b -n 1<br>rocm-smi --showpids<br>top -b -n 1 -o %CPU |
@@ -251,10 +251,27 @@ Collect NVMe details from the system.
251251

252252
**Link to code**: ../nodescraper/plugins/inband/nvme/nvme_collector.py
253253

254+
### Class Variables
255+
256+
- **CMD_LINUX**: `{'smart_log': 'nvme smart-log {dev}', 'error_log': 'nvme error-log {dev} --log-entries=256', 'id_ctrl': 'nvme id-ctrl {dev}', 'id_ns': 'nvme id-ns {dev}{ns}', 'fw_log': 'nvme fw-log {dev}', 'self_test_log': 'nvme self-test-log {dev}', 'get_log': 'nvme get-log {dev} --log-id=6 --log-len=512', 'telemetry_log': 'nvme telemetry-log {dev} --output-file={dev}_{f_name}'}`
257+
- **CMD_TEMPLATES**: `['nvme smart-log {dev}', 'nvme error-log {dev} --log-entries=256', 'nvme id-ctrl {dev}', 'nvme id-ns {dev}{ns}', 'nvme fw-log {dev}', 'nvme self-test-log {dev}', 'nvme get-log {dev} --log-id=6 --log-len=512', 'nvme telemetry-log {dev} --output-file={dev}_{f_name}']`
258+
- **TELEMETRY_FILENAME**: `telemetry_log.bin`
259+
254260
### Provides Data
255261

256262
NvmeDataModel
257263

264+
### Commands
265+
266+
- nvme smart-log {dev}
267+
- nvme error-log {dev} --log-entries=256
268+
- nvme id-ctrl {dev}
269+
- nvme id-ns {dev}{ns}
270+
- nvme fw-log {dev}
271+
- nvme self-test-log {dev}
272+
- nvme get-log {dev} --log-id=6 --log-len=512
273+
- nvme telemetry-log {dev} --output-file={dev}_{f_name}
274+
258275
## Collector Class OsCollector
259276

260277
### Description
@@ -461,10 +478,6 @@ UptimeDataModel
461478

462479
## BiosDataModel Model
463480

464-
### Description
465-
466-
Base class for data model, used to define structure of data collected from the system
467-
468481
**Link to code**: ../nodescraper/plugins/inband/bios/biosdata.py
469482

470483
**Bases**: ['DataModel']
@@ -475,10 +488,6 @@ Base class for data model, used to define structure of data collected from the s
475488

476489
## CmdlineDataModel Model
477490

478-
### Description
479-
480-
Base class for data model, used to define structure of data collected from the system
481-
482491
**Link to code**: ../nodescraper/plugins/inband/cmdline/cmdlinedata.py
483492

484493
**Bases**: ['DataModel']
@@ -489,10 +498,6 @@ Base class for data model, used to define structure of data collected from the s
489498

490499
## DimmDataModel Model
491500

492-
### Description
493-
494-
Base class for data model, used to define structure of data collected from the system
495-
496501
**Link to code**: ../nodescraper/plugins/inband/dimm/dimmdata.py
497502

498503
**Bases**: ['DataModel']
@@ -503,10 +508,6 @@ Base class for data model, used to define structure of data collected from the s
503508

504509
## DkmsDataModel Model
505510

506-
### Description
507-
508-
Base class for data model, used to define structure of data collected from the system
509-
510511
**Link to code**: ../nodescraper/plugins/inband/dkms/dkmsdata.py
511512

512513
**Bases**: ['DataModel']
@@ -546,10 +547,6 @@ Data model for journal logs
546547

547548
## KernelDataModel Model
548549

549-
### Description
550-
551-
Base class for data model, used to define structure of data collected from the system
552-
553550
**Link to code**: ../nodescraper/plugins/inband/kernel/kerneldata.py
554551

555552
**Bases**: ['DataModel']
@@ -560,10 +557,6 @@ Base class for data model, used to define structure of data collected from the s
560557

561558
## KernelModuleDataModel Model
562559

563-
### Description
564-
565-
Base class for data model, used to define structure of data collected from the system
566-
567560
**Link to code**: ../nodescraper/plugins/inband/kernel_module/kernel_module_data.py
568561

569562
**Bases**: ['DataModel']
@@ -574,10 +567,6 @@ Base class for data model, used to define structure of data collected from the s
574567

575568
## MemoryDataModel Model
576569

577-
### Description
578-
579-
Base class for data model, used to define structure of data collected from the system
580-
581570
**Link to code**: ../nodescraper/plugins/inband/memory/memorydata.py
582571

583572
**Bases**: ['DataModel']
@@ -589,10 +578,6 @@ Base class for data model, used to define structure of data collected from the s
589578

590579
## NvmeDataModel Model
591580

592-
### Description
593-
594-
Base class for data model, used to define structure of data collected from the system
595-
596581
**Link to code**: ../nodescraper/plugins/inband/nvme/nvmedata.py
597582

598583
**Bases**: ['DataModel']
@@ -603,10 +588,6 @@ Base class for data model, used to define structure of data collected from the s
603588

604589
## OsDataModel Model
605590

606-
### Description
607-
608-
Base class for data model, used to define structure of data collected from the system
609-
610591
**Link to code**: ../nodescraper/plugins/inband/os/osdata.py
611592

612593
**Bases**: ['DataModel']
@@ -632,10 +613,6 @@ Pacakge data contains the package data for the system
632613

633614
## ProcessDataModel Model
634615

635-
### Description
636-
637-
Base class for data model, used to define structure of data collected from the system
638-
639616
**Link to code**: ../nodescraper/plugins/inband/process/processdata.py
640617

641618
**Bases**: ['DataModel']
@@ -648,10 +625,6 @@ Base class for data model, used to define structure of data collected from the s
648625

649626
## RocmDataModel Model
650627

651-
### Description
652-
653-
Base class for data model, used to define structure of data collected from the system
654-
655628
**Link to code**: ../nodescraper/plugins/inband/rocm/rocmdata.py
656629

657630
**Bases**: ['DataModel']
@@ -662,10 +635,6 @@ Base class for data model, used to define structure of data collected from the s
662635

663636
## StorageDataModel Model
664637

665-
### Description
666-
667-
Base class for data model, used to define structure of data collected from the system
668-
669638
**Link to code**: ../nodescraper/plugins/inband/storage/storagedata.py
670639

671640
**Bases**: ['DataModel']
@@ -676,10 +645,6 @@ Base class for data model, used to define structure of data collected from the s
676645

677646
## SysctlDataModel Model
678647

679-
### Description
680-
681-
Base class for data model, used to define structure of data collected from the system
682-
683648
**Link to code**: ../nodescraper/plugins/inband/sysctl/sysctldata.py
684649

685650
**Bases**: ['DataModel']
@@ -714,10 +679,6 @@ Data model for in band syslog logs
714679

715680
## UptimeDataModel Model
716681

717-
### Description
718-
719-
Base class for data model, used to define structure of data collected from the system
720-
721682
**Link to code**: ../nodescraper/plugins/inband/uptime/uptimedata.py
722683

723684
**Bases**: ['DataModel']
@@ -926,6 +887,8 @@ Check sysctl matches expected sysctl details
926887
### Class Variables
927888

928889
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
890+
- **model_fields**: `{'exp_bios_version': FieldInfo(annotation=list[str], required=False, default_factory=list), 'regex_match': FieldInfo(annotation=bool, required=False, default=False)}`
891+
- **model_computed_fields**: `{}`
929892

930893
### Annotations / fields
931894

@@ -941,6 +904,8 @@ Check sysctl matches expected sysctl details
941904
### Class Variables
942905

943906
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
907+
- **model_fields**: `{'required_cmdline': FieldInfo(annotation=Union[str, list], required=False, default_factory=list), 'banned_cmdline': FieldInfo(annotation=Union[str, list], required=False, default_factory=list)}`
908+
- **model_computed_fields**: `{}`
944909

945910
### Annotations / fields
946911

@@ -956,6 +921,8 @@ Check sysctl matches expected sysctl details
956921
### Class Variables
957922

958923
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
924+
- **model_fields**: `{'dkms_status': FieldInfo(annotation=Union[str, list], required=False, default_factory=list), 'dkms_version': FieldInfo(annotation=Union[str, list], required=False, default_factory=list), 'regex_match': FieldInfo(annotation=bool, required=False, default=False)}`
925+
- **model_computed_fields**: `{}`
959926

960927
### Annotations / fields
961928

@@ -972,6 +939,8 @@ Check sysctl matches expected sysctl details
972939
### Class Variables
973940

974941
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
942+
- **model_fields**: `{'exp_kernel': FieldInfo(annotation=Union[str, list], required=False, default_factory=list), 'regex_match': FieldInfo(annotation=bool, required=False, default=False)}`
943+
- **model_computed_fields**: `{}`
975944

976945
### Annotations / fields
977946

@@ -987,6 +956,8 @@ Check sysctl matches expected sysctl details
987956
### Class Variables
988957

989958
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
959+
- **model_fields**: `{'kernel_modules': FieldInfo(annotation=dict[str, dict], required=False, default={}), 'regex_filter': FieldInfo(annotation=list[str], required=False, default=['amd'])}`
960+
- **model_computed_fields**: `{}`
990961

991962
### Annotations / fields
992963

@@ -1002,6 +973,8 @@ Check sysctl matches expected sysctl details
1002973
### Class Variables
1003974

1004975
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
976+
- **model_fields**: `{'exp_os': FieldInfo(annotation=Union[str, list], required=False, default_factory=list), 'exact_match': FieldInfo(annotation=bool, required=False, default=True)}`
977+
- **model_computed_fields**: `{}`
1005978

1006979
### Annotations / fields
1007980

@@ -1017,6 +990,8 @@ Check sysctl matches expected sysctl details
1017990
### Class Variables
1018991

1019992
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
993+
- **model_fields**: `{'exp_package_ver': FieldInfo(annotation=dict[str, Union[str, NoneType]], required=False, default_factory=dict), 'regex_match': FieldInfo(annotation=bool, required=False, default=False)}`
994+
- **model_computed_fields**: `{}`
1020995

1021996
### Annotations / fields
1022997

@@ -1032,6 +1007,8 @@ Check sysctl matches expected sysctl details
10321007
### Class Variables
10331008

10341009
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
1010+
- **model_fields**: `{'max_kfd_processes': FieldInfo(annotation=int, required=False, default=0), 'max_cpu_usage': FieldInfo(annotation=float, required=False, default=20.0)}`
1011+
- **model_computed_fields**: `{}`
10351012

10361013
### Annotations / fields
10371014

@@ -1047,6 +1024,8 @@ Check sysctl matches expected sysctl details
10471024
### Class Variables
10481025

10491026
- **model_config**: `{}`
1027+
- **model_fields**: `{'exp_rocm': FieldInfo(annotation=Union[str, list], required=False, default_factory=list)}`
1028+
- **model_computed_fields**: `{}`
10501029

10511030
### Annotations / fields
10521031

@@ -1061,6 +1040,8 @@ Check sysctl matches expected sysctl details
10611040
### Class Variables
10621041

10631042
- **model_config**: `{'extra': 'forbid', 'exclude_none': True}`
1043+
- **model_fields**: `{'exp_vm_swappiness': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_numa_balancing': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_oom_kill_allocating_task': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_compaction_proactiveness': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_compact_unevictable_allowed': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_extfrag_threshold': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_zone_reclaim_mode': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_dirty_background_ratio': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_dirty_ratio': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_vm_dirty_writeback_centisecs': FieldInfo(annotation=Union[int, NoneType], required=False, default=None), 'exp_kernel_numa_balancing': FieldInfo(annotation=Union[int, NoneType], required=False, default=None)}`
1044+
- **model_computed_fields**: `{}`
10641045

10651046
### Annotations / fields
10661047

0 commit comments

Comments
 (0)