Adapt charm to support COS integration

.github/workflows/integration_tests.yaml

@@ -100,6 +100,30 @@ jobs:
             --token ${{secrets.E2E_TESTING_TOKEN}} \
             --token-alt ${{secrets.E2E_TESTING_TOKEN_ALT}} \
             tests/integration/test_charm_scheduled_events.py
+  integration-test-charm-metrics:
+    name: Integration test charm metrics
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        juju: [ 3.1, 2.9 ]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup operator environment
+        uses: charmed-kubernetes/actions-operator@main
+        with:
+          juju-channel: ${{ matrix.juju }}/stable
+          provider: lxd
+      - name: Enable br_netfilter
+        run: sudo modprobe br_netfilter
+      - name: Run Integration tests
+        run: |
+          tox -e integration-juju${{ matrix.juju }} -- \
+            --keep-models \
+            --path ${{secrets.E2E_TESTING_REPO}} \
+            --token ${{secrets.E2E_TESTING_TOKEN}} \
+            --token-alt ${{secrets.E2E_TESTING_TOKEN_ALT}} \
+            tests/integration/test_charm_metrics.py
   required_status_checks:
     name: Required Integration Test Status Checks
     runs-on: ubuntu-latest
@@ -108,6 +132,7 @@ jobs:
       - integration-test-charm
       - integration-test-charm-fork-repo
       - integration-test-charm-scheduled-events
+      - integration-test-charm-metrics
     if: always() && !cancelled()
     timeout-minutes: 30
     steps:
@@ -116,3 +141,4 @@ jobs:
           [ '${{ needs.integration-test-charm.result }}' = 'success' ] || (echo integration-test-charm failed && false)
           [ '${{ needs.integration-test-charm-fork-repo.result }}' = 'success' ] || (echo integration-test-charm-fork-repo failed && false)
           [ '${{ needs.integration-test-charm-scheduled-events.result }}' = 'success' ] || (echo integration-test-charm-schedule-events failed && false)
+          [ '${{ needs.integration-test-charm-metrics.result }}' = 'success' ] || (echo integration-test-charm-metrics failed && false)

.licenserc.yaml

@@ -22,4 +22,6 @@ header:
     - 'CODEOWNERS'
     - 'icon.svg'
     - 'LICENSE'
+    - '.pylintrc'
+    - '.woke.yaml'
   comment: on-failure

.pylintrc

@@ -0,0 +1,2 @@
+[MAIN]
+extension-pkg-whitelist=pydantic  #  see https://github.com/pydantic/pydantic/issues/1961#issuecomment-759522422

.woke.yaml

@@ -0,0 +1,3 @@
+ignore_files:
+  # Ignore pylintrc as it uses non compliant terminology: whitelist
+  - .pylintrc

README.md

@@ -39,6 +39,34 @@ If there are more idle runners than configured, the oldest idle runners are unre
 
 During each time period, every unit will make one or more API calls to GitHub. The interval may need to be adjusted if the number of units is large enough to trigger [Rate Limiting](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting).
 
+
+## COS
+The charm is designed to provide comprehensive metrics and monitoring capabilities for both the Runners and the Charm itself. These metrics are made available through the `cos-agent` integration with the `cos_agent` interface. Additionally, a Grafana Dashboard is included to help visualize these metrics effectively.
+
+### Loki Integration
+#### Loki Push API
+The charm seamlessly integrates with Loki, a powerful log aggregation system, through the `cos_agent` interface. This integration allows the charm to push various metrics and logs related to the Runners and the Charm itself to a Loki instance. This provides valuable insights into the performance and behavior of your deployment.
+
+### Grafana Dashboard
+To make monitoring even more accessible, the charm comes with a pre-configured Grafana Dashboard. This dashboard is designed to visualize the metrics collected by the charm, making it easier for operators to track the health and performance of the system.
+
+#### Automated Dashboard Deployment
+You can automate the deployment of the Grafana Dashboard using the [cos-integration-k8s](https://charmhub.io/cos-configuration-k8s) charm. This simplifies the setup process and ensures that your monitoring infrastructure is ready to go with minimal manual intervention.
+
+#### Configuration Options
+To enable the automated deployment of the Grafana Dashboard, you can provide the following configuration options when deploying the `cos-integration-k8s` charm:
+
+```ini
+git_repo=https://https://github.com/canonical/github-runner-operator
+git_branch=main
+git_depth=1
+grafana_dashboards_path=src/grafana_dashboard_metrics
+```
+
+
+
+
+
 ## Development
 
 This charm uses black and flake8 for formatting. Both run with the lint stage of tox.