Skip to content

Commit 5b3e0a1

Browse files
authored
Merge pull request #44 from cobaltcore-dev/wip-corrections-prysm
Wip corrections prysm
2 parents 701aa95 + 45b838f commit 5b3e0a1

1 file changed

Lines changed: 66 additions & 42 deletions

File tree

README.md

Lines changed: 66 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -4,44 +4,50 @@
44

55
> **Disclaimer**
66
>
7-
> Prysm is currently under heavy development and may contain bugs, incomplete features, and
8-
> non-functional code. This project is in the testing and proof-of-concept stage, so please use it
9-
> with caution and be aware that it may not work as expected. Contributions and feedback are
10-
> appreciated as we continue to improve and stabilize the tool
7+
> Prysm is currently under heavy development and may contain bugs, incomplete
8+
> features, and non-functional code. This project is in the testing and
9+
> proof-of-concept stage, so please use it with caution and be aware that it
10+
> may not work as expected. Contributions and feedback are appreciated as we
11+
> continue to improve and stabilize the tool.
1112
1213
## Overview
1314

14-
Prysm is a versatile CLI tool designed to provide an efficient observability solution for a wide
15-
range of systems, including RadosGW (Rados Gateway), Ceph storage clusters, and various hardware
16-
components. With a multi-layered architecture, Prysm enables real-time monitoring, data collection,
17-
and analysis across diverse environments, ensuring optimal performance, compliance, and operational
18-
insights.
15+
Prysm is a versatile CLI tool designed to provide an efficient observability
16+
solution for a wide range of systems, including RadosGW (Rados Gateway), Ceph
17+
storage clusters, and various hardware components. With a multi-layered
18+
architecture, Prysm enables real-time monitoring, data collection, and analysis
19+
across diverse environments. It ensures optimal performance, compliance, and
20+
operational insights.
1921

2022
## Features
2123

22-
- Multi-system Support: Prysm supports RadosGW, Ceph clusters, and hardware monitoring, making it a
23-
comprehensive observability tool.
24-
- Flexible Architecture: Prysm’s four-layered architecture—Consumers, NATS, Remote Producers, and
25-
Nearby Producers—enables it to handle a variety of observability tasks with precision and
26-
scalability.
27-
- Diverse Data Collection: Collect and analyze metrics and logs from RadosGW, Ceph, and hardware
28-
devices such as disks. Producers can be configured to gather data locally or remotely, ensuring
29-
adaptability to different environments.
30-
- Real-time Messaging: Use NATS as the messaging backbone to enable real-time, low-latency
31-
communication between data producers and consumers, ensuring seamless data flow.
32-
- Customizable Output: Prysm supports multiple output formats, including console, NATS, and
33-
Prometheus, allowing you to tailor the tool to your specific observability requirements.
34-
- Standalone Functionality: Prysm can be used standalone for specific tasks, such as providing a
35-
metrics endpoint for Prometheus, checking disk health, or printing data directly to the console.
24+
- Multi-system Support: Prysm supports RadosGW, Ceph clusters, and hardware
25+
monitoring, making it a comprehensive observability tool.
26+
- Flexible Architecture: Prysm’s four-layered architecture—Consumers, NATS,
27+
Remote Producers, and Nearby Producers—enables it to handle a variety of
28+
observability tasks with precision and scalability.
29+
- Diverse Data Collection: Collect and analyze metrics and logs from RadosGW,
30+
Ceph, and hardware devices such as disks. Producers can be configured to
31+
gather data locally or remotely, ensuring adaptability to different
32+
environments.
33+
- Real-time Messaging: Use NATS as the messaging backbone to enable real-time,
34+
low-latency communication between data producers and consumers, ensuring
35+
seamless data flow.
36+
- Customizable Output: Prysm supports multiple output formats, including
37+
console, NATS, and Prometheus, allowing you to tailor the tool to your
38+
specific observability requirements.
39+
- Standalone Functionality: Prysm can be used standalone for specific tasks,
40+
such as providing a metrics endpoint for Prometheus, checking disk health, or
41+
printing data directly to the console.
3642

3743
## Components
3844

3945
### Consumers
4046

4147
Purpose:
4248

43-
- Process and analyze data received from various systems, including RadosGW, Ceph, and hardware
44-
components.
49+
- Process and analyze data received from various systems, including RadosGW,
50+
Ceph, and hardware components.
4551

4652
Key Responsibilities:
4753

@@ -69,8 +75,8 @@ Key Responsibilities:
6975

7076
Purpose:
7177

72-
- Collect metrics and logs from various systems via APIs or other interfaces, typically from outside
73-
the monitored environment.
78+
- Collect metrics and logs from various systems via APIs or other interfaces,
79+
typically from outside the monitored environment.
7480

7581
Key Responsibilities:
7682

@@ -86,13 +92,13 @@ Key Responsibilities:
8692

8793
Purpose:
8894

89-
- Deployed within the same network or environment as the monitored systems, allowing direct access
90-
to logs, metrics, and configuration files.
95+
- Allows direct access to logs, metrics, and configuration files. Deployed
96+
within the same network or environment as the monitored systems.
9197

9298
Key Responsibilities:
9399

94-
- Collect data directly from system log files, metrics endpoints, or hardware sensors (e.g., SMART
95-
attributes for disk health).
100+
- Collect data directly from system log files, metrics endpoints, or hardware
101+
sensors (e.g., SMART attributes for disk health).
96102
- Leverage proximity for lower latency and higher data fidelity.
97103
- Transmit collected data to NATS.
98104

@@ -103,29 +109,47 @@ Key Responsibilities:
103109

104110
## Usage
105111

106-
Prysm can be employed across a wide range of observability scenarios, from monitoring the health of
107-
Ceph storage clusters and RadosGW instances to ensuring the reliability of hardware components
108-
through SMART attribute analysis. Whether you need to integrate with Prometheus, send real-time
109-
alerts via NATS, or simply log and visualize system performance, Prysm offers the tools and
110-
flexibility to meet your needs.
112+
Prysm can be employed across a wide range of observability scenarios, from
113+
monitoring the health of Ceph storage clusters and RadosGW instances to
114+
ensuring the reliability of hardware components through SMART attribute
115+
analysis. Whether you need to integrate with Prometheus, send real-time alerts
116+
via NATS, or simply log and visualize system performance, Prysm offers the
117+
tools and flexibility to meet your needs.
111118

112119
## Support, Feedback, Contributing
113120

114-
This project is open to feature requests/suggestions, bug reports, etc. via [GitHub issues](https://github.com/cobaltcore-dev/prysm/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).
121+
This project is open to feature requests/suggestions, bug reports, etc. via
122+
[GitHub issues](https://github.com/cobaltcore-dev/prysm/issues). Contribution
123+
and feedback are encouraged and always welcome. For more information about how
124+
to contribute, the project structure, as well as additional contribution
125+
information, see our [Contribution Guidelines](CONTRIBUTING.md).
115126

116127
## Security / Disclosure
117128

118-
If you find any bug that may be a security problem, please follow our instructions in [our security policy](https://github.com/cobaltcore-dev/prysm/security/policy) on how to report it. Please do not create GitHub issues for security-related doubts or problems.
129+
If you find any bug that may be a security problem, please follow our
130+
instructions in [our security
131+
policy](https://github.com/cobaltcore-dev/prysm/security/policy) on how to
132+
report it. Please do not create GitHub issues for security-related doubts or
133+
problems.
119134

120135
## Code of Conduct
121136

122-
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/SAP/.github/blob/main/CODE_OF_CONDUCT.md) at all times.
137+
We as members, contributors, and leaders pledge to make participation in our
138+
community a harassment-free experience for everyone. By participating in this
139+
project, you agree to abide by its [Code of
140+
Conduct](https://github.com/SAP/.github/blob/main/CODE_OF_CONDUCT.md) at all
141+
times.
123142

124143
## Licensing
125144

126-
Copyright 2025 SAP SE or an SAP affiliate company and prysm contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/cobaltcore-dev/prysm).
145+
Copyright 2025 SAP SE or an SAP affiliate company and prysm contributors.
146+
Please see our [LICENSE](LICENSE) for copyright and license information.
147+
Detailed information including third-party components and their
148+
licensing/copyright information is available [via the REUSE
149+
tool](https://api.reuse.software/info/github.com/cobaltcore-dev/prysm).
127150

128151
---
129152

130-
> This README is a draft and will be updated as Prysm continues to evolve. Contributions,
131-
> suggestions, and feedback are welcome to help improve and expand the functionality of Prysm.
153+
> This README is a draft and will be updated as Prysm continues to evolve.
154+
> Contributions, suggestions, and feedback are welcome to help improve and
155+
> expand the functionality of Prysm.

0 commit comments

Comments
 (0)