cosl

from ops.charm import CharmBase # Required for actual COSIntegration usage from cosl.integrator import COSIntegration from cosl.rules import Rules # The 'cosl' library is primarily designed to be used within Juju charms. # 1. Basic usage: Defining observability rules # The Rules object encapsulates Prometheus/Grafana rules. try: # Rules are defined as a dictionary, typically loaded from YAML. example_rules_content = { "groups": [ { "name": "example_group", "rules": [ {"alert": "MyHighCPU", "expr": "node_cpu_usage_total > 0.9", "for": "5m"}, {"record": "job:cpu_usage_rate:avg1m", "expr": "rate(node_cpu_seconds_total[1m])"} ] } ] } my_rules = Rules(content=example_rules_content) print(f"Successfully created a Rules object:") print(my_rules.content) except Exception as e: print(f"Error creating Rules object: {e}") # 2. Advanced usage: Integrating with COS Lite in a Juju charm # The COSIntegration class requires a 'CharmBase' instance from the 'ops' library. # This part is illustrative and needs to be run within a Juju charm's context # (e.g., in a charm's __init__.py or a Juju 'ops' test harness). # class MyCOSCharm(CharmBase): # def __init__(self, framework): # super().__init__(framework) # self.cos = COSIntegration(self) # 'self' is the CharmBase instance # # You would then use self.cos to add rules, dashboards, etc. # # For example: self.cos.add_rules(my_rules) # self.framework.observe(self.cos.on.metrics_alert_rules_changed, self._on_rules_changed) # # def _on_rules_changed(self, event): # print(f"COS rules changed event detected for: {event.rules_path}") print("\nTo use COSIntegration, you need a Juju charm context (from 'ops' library).") print("See the commented-out code above for an example of how it's typically used.")