Skip to content
This repository was archived by the owner on Dec 8, 2025. It is now read-only.

Commit e108785

Browse files
Release of version 1.2.0, 1.2.1 and SPPCheck 1.0.0
Release of SPPCheck version 1.0.0 Note that this release does not include code documentation yet. It must still be transferred from the masters thesis into code documentation later on. ## [1.2.1] - 2022-08-21 ### Added * Release of SPPCheck v1.0.0 * Its changes will be logged within this file * SPPCheck function and internal structure * Added Grafana Dashboard for SPPCheck ### Changed * Upgraded CodeQL to v3 * Extended `SppUtils.mk_logger_file` method by an logger_dir argument to allow different log files for SPPMon and SPPCheck * Added "sppcheckLogs" to the gitignore file. * Moved all cSpell settings from the workspace file to the settings file * Removed/Moved total count of exceptions during execution * Moved verbose setting of sub-modules into init method to avoid issues and clarify program structure * Error-Messages now have the prefix "ERROR: " * Added InfluxClient function "get_list_rp" to query all retention policies, moving it out of existing functionality ### Fixed * Code scanning alert #2 and #3: Printing passwords into logger due to an faulty if-expression. * CheckPID file now uses the class-verbose setting and no longer ARGS-Verbose, making it independent of actual args. * Fixed PID file checks under windows * Fixed PID file entries not being deleted. * Removed unnecessary and confusing check when creating a SelectionQuery ### Known Issues * SPPCheck lacks a lot of documentation, which is to be delivered on a later date. ## [1.2.0] - 2022-06-17 ### Added * Adds FullLogs and LoadedSystem information to the Grafana SPPMon Runtime Duration panel. * Adds clarification that all timestamps are changed into second precision on insert. * Adds support for batch insert to insert into a different retention policy * Selection queries now also support an alternative retention policy to query from * CreateRP-Method in the influxClient to allow creating non-lasting retention policies * Adds pandas-stubs, openpyxl and pyxlsb to requirements file * Prints total count of errors during the execution if there are any - instead of "script finished" output * Added type spelling dictionary to the settings file * Added linting settings to the settings file * Added two new tables to the definitions.py file which are only executed if SPPCheck is executed. ### Changed * Moved pid files-functions and other functions from SPPMon to helper functions. * Adjusted log messages to make their message generic if required. * Added arguments to replace self-access. * Changed default log and pid-file locations from `home/sppmonLogs/FILE` to `spectrum-protect-sppmon/sppmonLogs/FILE` * Added init declarations in the SPPMon `__init__` function to allow overview of all self-vars * Changed SelectionQueries to only take a single table instead of an List of such, as it isn't required and complicates the code * Predefined retention policies are no longer protected in the definitions module. * Sending a select query now raises a error when it fails. * Allows SelectionQueries from table to be another inner-selection query * Changed all calls of the constructor * Made sure to only allow inner queries when using the selection-keyword. * Changed the severity of unknown type-annotation due to submodules not being typed from error to warning. * Minor printing edits when generifing Dashboard * Removes deprecated functions ### Fixed * Fixed typo in exception_utils.py file, renaming it and all references on it. * Lots of typos in the inline documentation * SelectionQuery and associated methods: Introduces Optional annotation to fix linter error ### Known Issues * In newer Grafana versions the dashboard import might corrupt the datasource name. A fix is unavailable yet, though the error is only visual. * Some typos in the table definitions (commited / uncommited) cannot be fixed. This would not be backward-compatible and break the database.
2 parents a357271 + 4e45add commit e108785

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

60 files changed

+13816
-1664
lines changed

.gitignore

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,11 @@ config_files/*
77
Grafana/customer_dashboards/*
88
!Grafana/customer_dashboards/.gitkeep
99

10+
# ### Log files ###
11+
12+
sppmonLogs/*
13+
sppcheckLogs/*
14+
1015
# `python` and `scripts are used as workspace dirs
1116
# ignore if vs code is opened up on top level
1217
.vs/*

CHANGELOG.md

Lines changed: 98 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,20 +5,106 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](http://keepachangelog.com/)
66
and this project adheres to [Semantic Versioning](http://semver.org/).
77

8+
## SPPMon [Unreleased] - yyyy-mm-dd
89

9-
## [Unreleased] - yyyy-mm-dd
10+
### Added
11+
12+
### Changed
13+
14+
### Fixed
15+
16+
### Known Issues
17+
18+
## SPPCheck [Unreleased] - yyyy-mm-dd
19+
20+
### Added
21+
22+
### Changed
23+
24+
### Fixed
25+
26+
### Known Issues
27+
28+
## [1.2.1] - 2022-08-21
29+
30+
### Added
31+
32+
* Release of SPPCheck v1.0.0
33+
* Its changes will be logged within this file
34+
* SPPCheck function and internal structure
35+
* Added Grafana Dashboard for SPPCheck
36+
37+
### Changed
38+
39+
* Upgraded CodeQL to v3
40+
* Extended `SppUtils.mk_logger_file` method by an logger_dir argument to allow different log files for SPPMon and SPPCheck
41+
* Added "sppcheckLogs" to the gitignore file.
42+
* Moved all cSpell settings from the workspace file to the settings file
43+
* Removed/Moved total count of exceptions during execution
44+
* Moved verbose setting of sub-modules into init method to avoid issues and clarify program structure
45+
* Error-Messages now have the prefix "ERROR: "
46+
* Added InfluxClient function "get_list_rp" to query all retention policies, moving it out of existing functionality
47+
48+
### Fixed
49+
50+
* Code scanning alert #2 and #3: Printing passwords into logger due to an faulty if-expression.
51+
* CheckPID file now uses the class-verbose setting and no longer ARGS-Verbose, making it independent of actual args.
52+
* Fixed PID file checks under windows
53+
* Fixed PID file entries not being deleted.
54+
* Removed unnecessary and confusing check when creating a SelectionQuery
55+
56+
### Known Issues
57+
58+
* SPPCheck lacks a lot of documentation, which is to be delivered on a later date.
59+
60+
## [1.2.0] - 2022-06-17
1061

1162
### Added
1263

64+
* Adds FullLogs and LoadedSystem information to the Grafana SPPMon Runtime Duration panel.
65+
* Adds clarification that all timestamps are changed into second precision on insert.
66+
* Adds support for batch insert to insert into a different retention policy
67+
* Selection queries now also support an alternative retention policy to query from
68+
* CreateRP-Method in the influxClient to allow creating non-lasting retention policies
69+
* Adds pandas-stubs, openpyxl and pyxlsb to requirements file
70+
* Prints total count of errors during the execution if there are any - instead of "script finished" output
71+
* Added type spelling dictionary to the settings file
72+
* Added linting settings to the settings file
73+
* Added two new tables to the definitions.py file which are only executed if SPPCheck is executed.
74+
1375
### Changed
1476

77+
* Moved pid files-functions and other functions from SPPMon to helper functions.
78+
* Adjusted log messages to make their message generic if required.
79+
* Added arguments to replace self-access.
80+
* Changed default log and pid-file locations from `home/sppmonLogs/FILE` to `spectrum-protect-sppmon/sppmonLogs/FILE`
81+
* Added init declarations in the SPPMon `__init__` function to allow overview of all self-vars
82+
* Changed SelectionQueries to only take a single table instead of an List of such, as it isn't required and complicates the code
83+
* Predefined retention policies are no longer protected in the definitions module.
84+
* Sending a select query now raises a error when it fails.
85+
* Allows SelectionQueries from table to be another inner-selection query
86+
* Changed all calls of the constructor
87+
* Made sure to only allow inner queries when using the selection-keyword.
88+
* Changed the severity of unknown type-annotation due to submodules not being typed from error to warning.
89+
* Minor printing edits when generifing Dashboard
90+
* Removes deprecated functions
91+
1592
### Fixed
1693

94+
* Fixed typo in exception_utils.py file, renaming it and all references on it.
95+
* Lots of typos in the inline documentation
96+
* SelectionQuery and associated methods: Introduces Optional annotation to fix linter error
97+
98+
### Known Issues
99+
100+
* In newer Grafana versions the dashboard import might corrupt the datasource name. A fix is unavailable yet, though the error is only visual.
101+
* Some typos in the table definitions (commited / uncommited) cannot be fixed. This would not be backward-compatible and break the database.
102+
17103
## [1.1.1] - 2022-02-22
18104

19105
### Added
20106

21-
* Adds FullLogs and LoadedSystem information to the Grafana SPPMon Runtime Duration panel.
107+
* Adds FullLogs and LoadedSystem information to the Grafana SPPMon Runtime Duration panel.
22108
* Adds license information into each SPPMon code file.
23109
* Specifies the encoding and reading permission when opening config files.
24110

@@ -121,7 +207,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
121207
* Corrupted config-file path no longer breaks SPPMon but prints an error message
122208
* Partly fixes #40, but some IDs still remain missing due to other issues. The fix is described within the issue.
123209
* JobLogs: The type-filter is no longer ignored on regular/loaded execution - requesting way fewer logs.
124-
* Fixed an error when importing individual job log statistics, and `ressourceType` was missing
210+
* Fixed an error when importing individual job log statistics, and `resourceType` was missing
125211

126212
#### Changes
127213

@@ -133,7 +219,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
133219
* Reworks REST-API POST-Requests to be merged with GET-Requests
134220
* This includes the repeated tries if a request fails
135221
* Deprecates `url_set_param`, using functionality of `requests`-package instead
136-
* Using Python-Structs for URL-params instead of cryptical encoded params
222+
* Using Python-Structs for URL-params instead of cryptic encoded params
137223
* Reworks REST-API requests to use parameters more efficiently and consistently, making the code hopefully more readable.
138224
* Changes get_url_params to gain all parameters from URL-Encoding
139225
* Introduces set_url_params to set all params into URL encoding
@@ -142,7 +228,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
142228
* Changed to query so-far unknown endpoint, using count and group aggregate to query all data with a single API-request
143229
> This brings the SLA request in line with the other API requests.
144230
* Reworked/Commented the job-log request and prepared a filter via individual JobLog-ID's
145-
* Labeled python argument ` -create_dashboard` and associated args as deprecated, to be removed in v1.1 (See Grafana-Changes)
231+
* Labeled python argument `-create_dashboard` and associated args as deprecated, to be removed in v1.1 (See Grafana-Changes)
146232

147233
### Influx
148234

@@ -184,7 +270,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
184270
* Changed dashboard to be exported for `external use`:
185271
* You may change the data source on importing
186272
* Both UID and Dashboard names will be variable generated based on the data source chosen
187-
* Labeled Python argument ` -create_dashboard` and associated args as deprecated, to be removed in v1.1
273+
* Labeled Python argument `-create_dashboard` and associated args as deprecated, to be removed in v1.1
188274
> Note: Listed here only for completeness, see Python changes
189275
* Created a Python stand-alone script for generifying dashboard
190276
> Note: Listed here only for completeness, see script changes
@@ -263,10 +349,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
263349

264350
### Changed
265351

266-
* Reminder: `--minimumLogs` depricated, to be removed in V1.0. Use `--loadedSystem` instead
267-
* `--processStats` depricated, integrated into `--ssh`
268-
* `transfer_data` removed. Use `copy_datase` instead.
269-
* removed `--old_database`, integraded into `copy_database` CFG file.
352+
* Reminder: `--minimumLogs` deprecated, to be removed in V1.0. Use `--loadedSystem` instead
353+
* `--processStats` deprecated, integrated into `--ssh`
354+
* `transfer_data` removed. Use `copy_database` instead.
355+
* removed `--old_database`, integrated into `copy_database` CFG file.
270356
* `--test` implemented
271357

272358
InfluxDB tables:
@@ -275,8 +361,8 @@ InfluxDB tables:
275361
* `jobs_statistics`: New
276362
* `jobLogs`: Renaming of arguments, adding `jobExecutionTime`.
277363
* `sppmon_metrics`: Added `influxdb_version` and new arguments
278-
* `vmReplicateSummary` and `vmReplicateStats`: `removed tag `messageId`
364+
* `vmReplicateSummary` and `vmReplicateStats`: `removed tag` messageId
279365
* `vadps`: Moved 3 tags to fields, adjusted CQ to run on distinct ID's
280366
* `ProcessStats`: Removed 2 fields and 3 tags due change `top` to `ps` command.
281367
* `office365stats` and `office365transfBytes` new
282-
* `df_ssh`: Renamed `avail` to `available`, bugfixing a tag
368+
* `df_ssh`: Renamed `avail` to `available`, bugfixing a tag

0 commit comments

Comments
 (0)