Add support for Sentry monitoring

Includes addition to documentation.

Author: pvannierop

README.md

@@ -2,6 +2,17 @@
 
 An application to get authorization from users to access their data through 3rd party APIs. Mainly supports OAuth2 Authorization code follow to request authorization and processes the returned authorization code to add new entries of users. It creates new users and adds properties compatible and required by the [RADAR REST and Fitbit connectors](https://github.com/RADAR-base/RADAR-REST-Connector).
 
+<!-- TOC -->
+* [RADAR-REST-Source-Auth](#radar-rest-source-auth)
+  * [Features supported](#features-supported)
+  * [APIs to be used by REST Source-Connectors](#apis-to-be-used-by-rest-source-connectors)
+  * [Installation](#installation)
+  * [Authorization](#authorization)
+    * [Registering OAuth Clients with ManagementPortal](#registering-oauth-clients-with-managementportal)
+  * [Sentry monitoring](#sentry-monitoring)
+  * [Migrating from 1.\*.\* version to 2.\*](#migrating-from-1-version-to-2)
+<!-- TOC -->
+
 ## Features supported
 
 1. It has one active entity where we store user properties.
@@ -60,6 +71,10 @@ callback-url: <advertised-url-of-rest-sources-authorizer-app>/login
 # the callback-url should be resolvable and match with the environment variable of radar-rest-sources-authorizer -> AUTH_CALLBACK_URL in the docker-compose.yml file. 
 ```
 
+## Sentry monitoring
+
+See [here](authorizer-app-backend/README.md#sentry-monitoring) for instructions on how to enable Sentry monitoring.
+
 ## Migrating from 1.\*.\* version to 2.\*
 
 1. Move configurations from application.yml and environment variables to `authorizer.yml` following the description in `authorizer.yml.template`.

authorizer-app-backend/README.md

@@ -0,0 +1,10 @@
+# RADAR-REST-Source-Auth backend
+
+This is the backend for the RADAR REST Source Authorizer application.
+
+## Sentry monitoring
+
+To enable Sentry monitoring:
+1. Set a `SENTRY_DSN` environment variable that points to the desired Sentry DSN.
+2. (Optional) Set the `SENTRY_LOG_LEVEL` environment variable to control the minimum log level of events sent to Sentry.
+   The default log level for Sentry is `WARN`. Possible values are `TRACE`, `DEBUG`, `INFO`, `WARN`, and `ERROR`.

authorizer-app-backend/build.gradle.kts

@@ -4,6 +4,9 @@ plugins {
     kotlin("plugin.noarg")
     kotlin("plugin.jpa")
     kotlin("plugin.allopen")
+    // TODO Remove this when new release of radar-commons is available and used in this project.
+    // This version has Sentry support built in for radar-kotlin plugin.
+    id("io.sentry.jvm.gradle") version "4.11.0"
 }
 
 application {

authorizer-app-backend/src/main/resources/log4j2.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+  ~ /*
+  ~  *  Copyright 2024 The Hyve
+  ~  *
+  ~  *  Licensed under the Apache License, Version 2.0 (the "License");
+  ~  *  you may not use this file except in compliance with the License.
+  ~  *  You may obtain a copy of the License at
+  ~  *
+  ~  *    http://www.apache.org/licenses/LICENSE-2.0
+  ~  *
+  ~  *  Unless required by applicable law or agreed to in writing, software
+  ~  *  distributed under the License is distributed on an "AS IS" BASIS,
+  ~  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~  *  See the License for the specific language governing permissions and
+  ~  *  limitations under the License.
+  ~  */
+  -->
+
+<configuration status="INFO">
+    <appenders>
+        <Console name="Console" target="SYSTEM_OUT">
+            <PatternLayout
+                    pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"
+            />
+        </Console>
+        <!-- For Sentry to work the DSN must be set via SENTRY_DSN environment variable
+             When SENTRY_DSN is empty string, the Sentry SDK is disabled -->
+        <Sentry name="Sentry" debug="false"/>
+    </appenders>
+
+    <loggers>
+        <root level="INFO">
+            <appender-ref ref="Console" />
+            <!-- Note that the Sentry logging threshold is at WARN level by default -->
+            <appender-ref ref="Sentry" level="${env:SENTRY_LOG_LEVEL:-WARN}" />
+        </root>
+    </loggers>
+</configuration>