1
0
Fork 0
mirror of https://github.com/kyverno/policy-reporter.git synced 2024-12-15 17:50:58 +00:00
Monitoring and Observability Tool for the PolicyReport CRD with an optional UI.
Find a file
Frank Jogeleit 11345a33f9
Merge pull request #252 from kyverno/policy-report-source
Add Source to PolicyReport
2023-01-22 11:23:36 +01:00
.github Dependency Updates (#200) 2022-09-12 00:21:23 +02:00
charts/policy-reporter feat: support topologyspreadconstraints in deployments 2023-01-16 14:42:33 +01:00
cmd Update logging 2022-08-25 15:24:29 +02:00
docs/images Monitoring improvements (#23) 2021-04-10 11:16:46 +02:00
manifest Add default prometheus annotations 2023-01-06 14:34:14 +13:00
pkg add source to policy_report table 2023-01-22 11:19:33 +01:00
templates fallback rule mapping to message 2022-07-04 15:42:25 +02:00
.dockerignore Internal Rewrite (#91) 2021-12-13 16:02:40 +01:00
.gitignore add slack as env var (#196) 2022-09-11 21:55:35 +02:00
CHANGELOG.md Prepare release 2.14.1 (#235) 2022-12-17 14:03:15 +01:00
CODE_OF_CONDUCT.md Add COC and Contribution docs 2022-08-29 21:31:45 +02:00
CONTRIBUTING.md Add COC and Contribution docs 2022-08-29 21:31:45 +02:00
Dockerfile Dependency Updates (#200) 2022-09-12 00:21:23 +02:00
go.mod bump golang.org/x/net from 0.2.0 to 0.5.0 2023-01-14 20:35:53 +08:00
go.sum bump golang.org/x/net from 0.2.0 to 0.5.0 2023-01-14 20:35:53 +08:00
LICENSE.md init 2021-02-20 00:58:01 +01:00
main.go update repository owner (#50) 2021-07-23 10:05:20 +02:00
Makefile Add new severities and update Chart 2022-08-25 13:23:03 +02:00
README.md Update Documentation Links 2022-07-12 10:06:18 +02:00

Policy Reporter

CI Go Report Card Coverage Status

Motivation

Kyverno ships with two types of validation. You can either enforce a rule or audit it. If you don't want to block developers or if you want to try out a new rule, you can use the audit functionality. The audit configuration creates PolicyReports which you can access with kubectl. Because I can't find a simple solution to get a general overview of this PolicyReports and PolicyReportResults, I created this tool to send information about PolicyReports to different targets like Grafana Loki, Elasticsearch or Slack.

Policy Reporter provides also a Prometheus Metrics API as well as an standalone mode along with the Policy Reporter UI.

This project is in an early stage. Please let me know if anything did not work as expected or if you want to send your audits to unsupported targets.

Documentation

You can find detailed Information and Screens about Features and Configurations in the Documentation.

Getting Started

Installation with Helm v3

Installation via Helm Repository

Add the Helm repository

helm repo add policy-reporter https://kyverno.github.io/policy-reporter
helm repo update

Basic Installation

The basic installation provides optional Prometheus Metrics and/or optional REST APIs, for more details have a look at the Documentation.

helm install policy-reporter policy-reporter/policy-reporter -n policy-reporter --set metrics.enabled=true --set rest.enabled=true --create-namespace

Installation without Helm or Kustomize

To install Policy Reporter without Helm or Kustomize have a look at manifests.

Policy Reporter UI

You can use the Policy Reporter as standalone Application along with the optional UI SubChart.

Installation with Policy Reporter UI and Kyverno Plugin enabled

helm install policy-reporter policy-reporter/policy-reporter --set kyvernoPlugin.enabled=true --set ui.enabled=true --set ui.plugins.kyverno=true -n policy-reporter --create-namespace
kubectl port-forward service/policy-reporter-ui 8082:8080 -n policy-reporter

Open http://localhost:8082/ in your browser.

Check the Documentation for Screens and additional Information

Targets

Policy Reporter supports the following Targets to send new (Cluster)PolicyReport Results too:

Monitoring

The Helm Chart includes optional SubChart for Prometheus Operator Integration. The provided Dashboards working without Loki and are only based on the Prometheus Metrics.

Have a look into the Documentation for details.

Grafana Dashboard Import

If you are not using the MonitoringStack you can import the dashboards from Grafana

Resources