From b204addfb59612b86bda389dfda3d6778dc7f82e Mon Sep 17 00:00:00 2001 From: Eduard Schander <66794307+EddeCCC@users.noreply.github.com> Date: Fri, 8 Dec 2023 09:15:24 +0100 Subject: [PATCH] Revert "Metrics tracing tags (#1626)" (#1628) This reverts commit 219f9edfd4cb8092ca45bedc48d81337ea02819a. --- .../views/configuration/ConfigurationView.js | 4 +- .../views/configuration/FileToolbar.js | 14 - .../views/dialogs/DownloadDialogue.js | 25 +- .../components/views/status/StatusTable.js | 25 +- .../src/components/views/status/StatusView.js | 71 ++-- .../dialogs/AgentHealthStateDialogue.js | 152 --------- .../src/lib/axios-api.js | 2 +- .../ocelot/agentstatus/AgentStatus.java | 4 +- .../agentstatus/AgentStatusManager.java | 25 +- .../src/main/resources/application.yml | 1 - inspectit-ocelot-config/build.gradle | 1 + .../models/health/AgentHealthIncident.java | 28 -- .../models/health/AgentHealthState.java | 23 -- .../config/model/metrics/MetricsSettings.java | 7 +- .../model/metrics/TagGuardSettings.java | 50 --- .../definition/MetricDefinitionSettings.java | 3 - .../selfmonitoring/AgentHealthSettings.java | 25 +- .../config/model/tracing/TracingSettings.java | 8 +- .../ocelot/config/default/basics.yml | 9 - .../ocelot/config/default/self-monitoring.yml | 8 - .../InspectIT Agent/tag-guard-database.json | 1 - .../handler/impl/LogsCommandExecutor.java | 2 +- .../http/HttpConfigurationPoller.java | 17 +- .../http/HttpPropertySourceState.java | 20 +- .../exporter/OtlpMetricsExporterService.java | 2 +- .../MethodHookConfigurationResolver.java | 2 +- .../hook/MethodHookGenerator.java | 49 +-- .../hook/actions/MetricsRecorder.java | 41 ++- .../span/ContinueOrStartSpanAction.java | 3 +- .../span/WriteSpanAttributesAction.java | 6 +- .../core/metrics/MeasureTagValueGuard.java | 302 ------------------ .../AgentHealthIncidentBuffer.java | 56 ---- .../selfmonitoring/AgentHealthManager.java | 230 +++++++------ .../{logs => }/LogMetricsRecorder.java | 3 +- .../{logs => }/LogPreloader.java | 2 +- .../{models => }/AgentHealthChangedEvent.java | 13 +- .../event/listener/HealthEventListener.java | 13 - .../LogWritingHealthEventListener.java | 23 -- .../MetricWritingHealthEventListener.java | 35 -- .../PollerWritingHealthEventListener.java | 42 --- .../models/AgentHealthIncidentAddedEvent.java | 22 -- .../selfmonitoring/logs/LogHealthMonitor.java | 51 --- .../inspectit/ocelot/core/tags/TagUtils.java | 14 +- .../handler/impl/LogsCommandExecutorTest.java | 2 +- .../ExporterServiceIntegrationTestBase.java | 58 ++-- .../OtlpMetricsExporterServiceIntTest.java | 20 +- .../hook/MethodHookGeneratorTest.java | 251 +-------------- .../hook/actions/MetricsRecorderTest.java | 62 ++-- .../InternalProcessingAppenderTest.java | 2 +- .../metrics/MeasureTagValueGuardIntTest.java | 113 ------- .../metrics/MeasureTagValueGuardTest.java | 302 ------------------ .../AgentHealthIncidentBufferTest.java | 55 ---- ...entHealthManagerDeadlockGh1597IntTest.java | 8 +- .../AgentHealthManagerIntTest.java | 107 ------- .../AgentHealthManagerTest.java | 191 ++++++----- .../{logs => }/LogMetricsIntTest.java | 3 +- .../{logs => }/LogMetricsRecorderTest.java | 3 +- .../{logs => }/LogPreloaderTest.java | 2 +- .../LogWritingHealthEventListenerTest.java | 44 --- .../MetricWritingHealthEventListenerTest.java | 48 --- .../PollerWritingHealthEventListenerTest.java | 60 ---- .../logs/LogHealthMonitorTest.java | 101 ------ ...micallyActivatableServiceObserverTest.java | 2 +- .../docs/assets/agent-health-incidents.png | Bin 138677 -> 0 bytes .../docs/config-server/agent-mappings.md | 5 +- .../docs/metrics/tag-guard.md | 98 ------ .../docs/tracing/tracing.md | 59 +--- .../website/sidebars.json | 3 +- 68 files changed, 422 insertions(+), 2611 deletions(-) delete mode 100644 components/inspectit-ocelot-configurationserver-ui/src/components/views/status/dialogs/AgentHealthStateDialogue.js delete mode 100644 inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthIncident.java delete mode 100644 inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthState.java delete mode 100644 inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/TagGuardSettings.java delete mode 100644 inspectit-ocelot-core/${inspectit.env.agent-dir}/InspectIT Agent/tag-guard-database.json delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuard.java delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBuffer.java rename inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/{logs => }/LogMetricsRecorder.java (91%) rename inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/{logs => }/LogPreloader.java (99%) rename inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/{models => }/AgentHealthChangedEvent.java (67%) delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/HealthEventListener.java delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListener.java delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListener.java delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListener.java delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthIncidentAddedEvent.java delete mode 100644 inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitor.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardIntTest.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardTest.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBufferTest.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerIntTest.java rename inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/{logs => }/LogMetricsIntTest.java (96%) rename inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/{logs => }/LogMetricsRecorderTest.java (93%) rename inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/{logs => }/LogPreloaderTest.java (98%) delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListenerTest.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListenerTest.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListenerTest.java delete mode 100644 inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitorTest.java delete mode 100644 inspectit-ocelot-documentation/docs/assets/agent-health-incidents.png delete mode 100644 inspectit-ocelot-documentation/docs/metrics/tag-guard.md diff --git a/components/inspectit-ocelot-configurationserver-ui/src/components/views/configuration/ConfigurationView.js b/components/inspectit-ocelot-configurationserver-ui/src/components/views/configuration/ConfigurationView.js index 5a44cd26b4..1a3498059d 100644 --- a/components/inspectit-ocelot-configurationserver-ui/src/components/views/configuration/ConfigurationView.js +++ b/components/inspectit-ocelot-configurationserver-ui/src/components/views/configuration/ConfigurationView.js @@ -165,7 +165,7 @@ class ConfigurationView extends React.Component { * If no version is specified, the latest version will be selected. */ openFile = (filename, versionId = null) => { - if (this.props.selectedVersion !== versionId) { + if (this.props.selectedVersion != versionId) { this.props.selectVersion(versionId, false); } this.props.selectFile(filename); @@ -191,6 +191,7 @@ class ConfigurationView extends React.Component { canWrite, } = this.props; const showEditor = (selection || selectedDefaultConfigFile) && !isDirectory; + const { path, name } = this.parsePath(selection, selectedDefaultConfigFile); const icon = 'pi-' + (isDirectory ? 'folder' : 'file'); const showHeader = !!name; @@ -198,6 +199,7 @@ class ConfigurationView extends React.Component { const readOnly = !canWrite || !!selectedDefaultConfigFile || !isLatestVersion; const fileContentWithoutFirstLine = fileContent ? fileContent.split('\n').slice(1).join('\n') : ''; + return (
+
} > @@ -101,10 +86,6 @@ DownloadDialogue.propTypes = { contentType: PropTypes.string, /** The name of the data's context. E.g. the agent whose logs are being shown.*/ contextName: PropTypes.string, - /** Whether the cancel Button is disabled */ - disableDownloadCancelButton: PropTypes.bool, - /** Callback on dialog cancel */ - onCancel: PropTypes.func, }; DownloadDialogue.defaultProps = { diff --git a/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/StatusTable.js b/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/StatusTable.js index 6be7443a78..dd82d581ec 100644 --- a/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/StatusTable.js +++ b/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/StatusTable.js @@ -53,19 +53,23 @@ class AgentMappingCell extends React.Component { display: flex; align-items: stretch; } + .mapping-name { flex: 1; margin-right: 0.5rem; } + .no-mapping { color: gray; font-style: italic; } + .show-attributes { float: right; cursor: pointer; color: #007ad9; } + .attributes { margin-top: 0.5rem; border-left: 0.25rem solid #ddd; @@ -170,6 +174,7 @@ class StatusTable extends React.Component { .this { position: relative; } + .this :global(.config-info-button) { width: 1.2rem; height: 1.2rem; @@ -179,6 +184,7 @@ class StatusTable extends React.Component { background: #ddd; border-color: #ddd; } + .this :global(.log-button) { width: 1.2rem; height: 1.2rem; @@ -188,6 +194,7 @@ class StatusTable extends React.Component { background: #ddd; border-color: #ddd; } + .this :global(.service-state-button) { width: 1.2rem; height: 1.2rem; @@ -197,6 +204,7 @@ class StatusTable extends React.Component { background: #ddd; border-color: #ddd; } + .this :global(.badge) { width: 1.2rem; height: 1.2rem; @@ -209,6 +217,7 @@ class StatusTable extends React.Component { justify-content: center; color: white; } + .this :global(.might-overflow) { max-width: 17.8rem; display: inline-block; @@ -292,11 +301,8 @@ class StatusTable extends React.Component { }; agentHealthTemplate = (rowData) => { - const { onShowHealthStateDialog } = this.props; - const { healthState, metaInformation } = rowData; - const { health } = healthState; - const { agentId } = metaInformation; const { onShowDownloadDialog } = this.props; + const { health, metaInformation } = rowData; let { agentCommandsEnabled, supportArchiveAvailable } = this.resolveServiceAvailability(metaInformation); @@ -320,14 +326,12 @@ class StatusTable extends React.Component { iconColor = '#e8c413'; break; } - return ( <> {health ? (
-
onShowHealthStateDialog(agentId, healthState)}> - - {healthInfo} -
+ + {healthInfo}
this.setShowDownloadDialog(false)} + visible={isDownloadDialogShown} + onHide={() => this.setDownloadDialogShown(false)} error={contentLoadingFailed} loading={isLoading} contentValue={contentValue} contentType={contentType} contextName={'Agent ' + agentId} - isDownloadDialogFooterHidden={isDownloadDialogFooterHidden} - onCancel={() => { - this.setShowDownloadDialog(false); - this.axiosAbortController.abort(); - }} - /> - this.setShowHealthStateDialog(false)} - contentValue={this.state.attributes} - contextName={'Agent ' + agentId} /> { - this.setState({ - showDownloadDialog: showDialog, - }); - }; + setDownloadDialogShown = (showDialog) => { + if (showDialog == false) { + controller.abort(); + controller = new AbortController(); // A new instance has to be created in order for new requests to be accepted + } - setShowHealthStateDialog = (showDialog) => { this.setState({ - showHealthStateDialog: showDialog, + isDownloadDialogShown: showDialog, }); }; showDownloadDialog = (agentId, attributes, contentType) => { - this.setShowDownloadDialog(true); + this.setDownloadDialogShown(true); this.setState( { agentId, @@ -352,47 +334,36 @@ class StatusView extends React.Component { this.downloadSupportArchive(agentId, attributes); break; default: - this.setShowDownloadDialog(false); + this.setDownloadDialogShown(false); break; } } ); }; - showHealthStateDialog = (agentId, attributes) => { - this.setShowHealthStateDialog(true); - this.setState({ - agentId, - attributes, - }); - }; - downloadSupportArchive = (agentId, agentVersion) => { this.setState( { isLoading: true, - isDownloadDialogFooterHidden: true, }, () => { axios .get('/agent/supportArchive', { - signal: this.axiosAbortController.signal, params: { 'agent-id': agentId }, + signal: controller.signal, }) .then((res) => { - downloadArchiveFromJson(res.data, agentId, agentVersion); - this.setShowDownloadDialog(false); this.setState({ isLoading: false, - isDownloadDialogFooterHidden: false, }); + downloadArchiveFromJson(res.data, agentId, agentVersion); + this.setDownloadDialogShown(false); }) .catch(() => { this.setState({ - contentValue: '', + contentValue: null, contentLoadingFailed: true, isLoading: false, - isDownloadDialogFooterHidden: false, }); }); } @@ -411,8 +382,8 @@ class StatusView extends React.Component { () => { axios .get('/configuration/agent-configuration', { - signal: this.axiosAbortController.signal, params: { ...requestParams }, + signal: controller.signal, }) .then((res) => { this.setState({ @@ -440,8 +411,8 @@ class StatusView extends React.Component { () => { axios .get('/command/logs', { - signal: this.axiosAbortController.signal, params: { 'agent-id': agentId }, + signal: controller.signal, }) .then((res) => { this.setState({ diff --git a/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/dialogs/AgentHealthStateDialogue.js b/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/dialogs/AgentHealthStateDialogue.js deleted file mode 100644 index b8d2d89ba1..0000000000 --- a/components/inspectit-ocelot-configurationserver-ui/src/components/views/status/dialogs/AgentHealthStateDialogue.js +++ /dev/null @@ -1,152 +0,0 @@ -import React from 'react'; -import { Dialog } from 'primereact/dialog'; -import { Button } from 'primereact/button'; -import PropTypes from 'prop-types'; - -/** - * Dialog that shows the given content, applying syntax highlighting if available, and offering a download option - */ -const AgentHealthStateDialogue = ({ visible, onHide, error, contentValue, contextName }) => { - const { health, source, message, history } = contentValue; - const { healthInfo, iconColor } = resolveHealthState(health); - - let latestIncidentElement = <>There are no incidents.; - - if (source && message) { - latestIncidentElement = ( - <> -
-

Latest Incident:

-
-
- {source}: {message} -
-
- - ); - } - - const historyElements = []; - if (history && history.length > 0) { - historyElements.push( -
-

History:

-
- ); - history.forEach((value) => { - const { time, source, health, message } = value; - const { healthInfo, iconColor } = resolveHealthState(health); - historyElements.push( -
- {time} {healthInfo}{' '} - {source}:
{message} -
-
- ); - }); - } - return ( - <> - - -
- } - > - {error ? ( -
- ) : ( - <> -
-

- The agent is in an - {healthInfo} - state -

-
- {latestIncidentElement} -
{historyElements}
- - )} -
- - ); -}; - -AgentHealthStateDialogue.propTypes = { - /** Whether a error is thrown */ - error: PropTypes.bool, - /** Whether the dialog is visible */ - visible: PropTypes.bool, - /** Callback on dialog hide */ - onHide: PropTypes.func, - /** The string value being displayed. E.g. the logs.*/ - contentValue: PropTypes.string, - /** The type of content. E.g. config or log.*/ - contentType: PropTypes.string, - /** The name of the data's context. E.g. the agent whose logs are being shown.*/ - contextName: PropTypes.string, -}; - -AgentHealthStateDialogue.defaultProps = { - error: false, - visible: true, - onHide: () => {}, - contentValue: 'No content found', - contentType: '', -}; - -const resolveHealthState = (health) => { - switch (health) { - case 'OK': - return { - healthInfo: ' OK ', - iconClass: 'pi-check-circle', - iconColor: '#0abd04', - }; - case 'WARNING': - return { - healthInfo: ' Warning ', - iconClass: 'pi-minus-circle', - iconColor: '#e8c413', - }; - } - return { - healthInfo: ' Error ', - iconClass: 'pi-times-circle', - iconColor: 'red', - }; -}; - -export default AgentHealthStateDialogue; diff --git a/components/inspectit-ocelot-configurationserver-ui/src/lib/axios-api.js b/components/inspectit-ocelot-configurationserver-ui/src/lib/axios-api.js index 3b4830d162..0bff230596 100644 --- a/components/inspectit-ocelot-configurationserver-ui/src/lib/axios-api.js +++ b/components/inspectit-ocelot-configurationserver-ui/src/lib/axios-api.js @@ -18,7 +18,7 @@ const axiosBearer = axios.create(commonConfiguration); // Request Interceptors /** - * Ensures requests are authenticated using the bearer token. + * Ensures requres are authenticated using the bearer token. */ axiosBearer.interceptors.request.use( function (config) { diff --git a/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatus.java b/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatus.java index 7469207d7e..59a52df5a8 100644 --- a/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatus.java +++ b/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatus.java @@ -4,7 +4,7 @@ import lombok.Builder; import lombok.Data; import lombok.NoArgsConstructor; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthState; +import rocks.inspectit.ocelot.commons.models.health.AgentHealth; import java.util.Date; import java.util.Map; @@ -47,5 +47,5 @@ public class AgentStatus { /** * The health status of the agent. */ - private AgentHealthState healthState; + private AgentHealth health; } diff --git a/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatusManager.java b/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatusManager.java index ac9c5e585d..8a2cf8e92d 100644 --- a/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatusManager.java +++ b/components/inspectit-ocelot-configurationserver/src/main/java/rocks/inspectit/ocelot/agentstatus/AgentStatusManager.java @@ -1,8 +1,5 @@ package rocks.inspectit.ocelot.agentstatus; -import com.fasterxml.jackson.core.JsonProcessingException; -import com.fasterxml.jackson.databind.ObjectMapper; -import com.fasterxml.jackson.databind.ObjectReader; import com.google.common.annotations.VisibleForTesting; import com.google.common.cache.Cache; import com.google.common.cache.CacheBuilder; @@ -12,7 +9,6 @@ import org.springframework.stereotype.Component; import rocks.inspectit.ocelot.agentconfiguration.AgentConfiguration; import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthState; import rocks.inspectit.ocelot.config.model.InspectitServerSettings; import java.util.Collection; @@ -83,28 +79,19 @@ public void notifyAgentConfigurationFetched(Map agentAttributes, } if (headers.containsKey(HEADER_AGENT_HEALTH)) { - ObjectReader objectReader = new ObjectMapper().reader().forType(AgentHealthState.class); - - AgentHealthState agentHealthState = null; - try { - agentHealthState = objectReader.readValue(headers.get(HEADER_AGENT_HEALTH)); - } catch (JsonProcessingException e) { //If this exception occurs we assume the corresponding agent uses the legacy health indicator. - AgentHealth agentHealth = AgentHealth.valueOf(headers.get(HEADER_AGENT_HEALTH)); - agentHealthState = AgentHealthState.defaultState(); - agentHealthState.setHealth(agentHealth); - } - agentStatus.setHealthState(agentHealthState); - logHealthIfChanged(statusKey, agentHealthState); + AgentHealth agentHealth = AgentHealth.valueOf(headers.get(HEADER_AGENT_HEALTH)); + agentStatus.setHealth(agentHealth); + logHealthIfChanged(statusKey, agentHealth); } attributesToAgentStatusCache.put(statusKey, agentStatus); } - private void logHealthIfChanged(Object statusKey, AgentHealthState agentHealthState) { + private void logHealthIfChanged(Object statusKey, AgentHealth agentHealth) { AgentStatus lastStatus = attributesToAgentStatusCache.getIfPresent(statusKey); - if (lastStatus == null || lastStatus.getHealthState().getHealth() != agentHealthState.getHealth()) { - log.info("Health of agent {} changed to {}.", statusKey, agentHealthState); + if (lastStatus == null || lastStatus.getHealth() != agentHealth) { + log.info("Health of agent {} changed to {}.", statusKey, agentHealth); } } diff --git a/components/inspectit-ocelot-configurationserver/src/main/resources/application.yml b/components/inspectit-ocelot-configurationserver/src/main/resources/application.yml index 4a197b722d..1e5dab04b4 100644 --- a/components/inspectit-ocelot-configurationserver/src/main/resources/application.yml +++ b/components/inspectit-ocelot-configurationserver/src/main/resources/application.yml @@ -28,7 +28,6 @@ spring: # server properties - see https://docs.spring.io/spring-boot/docs/current/reference/html/appendix-application-properties.html#server-properties server: port: 8090 - max-http-header-size: 1MB inspectit-config-server: # the directory which is used as working directory diff --git a/inspectit-ocelot-config/build.gradle b/inspectit-ocelot-config/build.gradle index ca4c9bfd85..55a21c625c 100644 --- a/inspectit-ocelot-config/build.gradle +++ b/inspectit-ocelot-config/build.gradle @@ -43,6 +43,7 @@ dependencies { libs.orgApacheCommonsCommonsLang3, libs.commonsIo, libs.comFasterxmlJacksonCoreJacksonDatabind, + // logging libs.chQosLogbackLogbackClassic, ) diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthIncident.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthIncident.java deleted file mode 100644 index 2a55d81948..0000000000 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthIncident.java +++ /dev/null @@ -1,28 +0,0 @@ -package rocks.inspectit.ocelot.commons.models.health; - -import lombok.AllArgsConstructor; -import lombok.Data; -import lombok.NoArgsConstructor; - -import java.time.LocalDateTime; - -@Data -@AllArgsConstructor -@NoArgsConstructor -public class AgentHealthIncident implements Comparable { - - private String time; - private AgentHealth health; - private String source; - private String message; - private boolean changedHealth; - - @Override - public int compareTo(Object o) { - if(!(o instanceof AgentHealthIncident)) { - return 1; - } - AgentHealthIncident healthIncident = (AgentHealthIncident) o; - return this.getHealth().compareTo(healthIncident.getHealth()); - } -} diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthState.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthState.java deleted file mode 100644 index 6a190be850..0000000000 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/commons/models/health/AgentHealthState.java +++ /dev/null @@ -1,23 +0,0 @@ -package rocks.inspectit.ocelot.commons.models.health; - -import lombok.AllArgsConstructor; -import lombok.Data; -import lombok.NoArgsConstructor; - -import java.util.Collections; -import java.util.List; - -@Data -@NoArgsConstructor -@AllArgsConstructor -public class AgentHealthState { - - private AgentHealth health; - private String source; - private String message; - private List history; - - public static AgentHealthState defaultState() { - return new AgentHealthState(AgentHealth.OK, "", "", Collections.emptyList()); - } -} diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/MetricsSettings.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/MetricsSettings.java index c9aa327d6d..c0b086c555 100644 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/MetricsSettings.java +++ b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/MetricsSettings.java @@ -38,11 +38,6 @@ public class MetricsSettings { */ private Duration frequency; - /** - * Settings for controlling the amount of unique tag values - */ - private TagGuardSettings tagGuard; - @NotNull private Map<@NotBlank String, @NotNull @Valid MetricDefinitionSettings> definitions = Collections.emptyMap(); @@ -89,6 +84,8 @@ public class MetricsSettings { @NotNull private JmxMetricsRecorderSettings jmx; + + @AdditionalValidation public void noDuplicateViewNames(ViolationBuilder vios) { Map viewsToMeasuresMap = new HashMap<>(); diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/TagGuardSettings.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/TagGuardSettings.java deleted file mode 100644 index cf1c05518a..0000000000 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/TagGuardSettings.java +++ /dev/null @@ -1,50 +0,0 @@ -package rocks.inspectit.ocelot.config.model.metrics; - -import lombok.Data; -import lombok.NoArgsConstructor; -import rocks.inspectit.ocelot.config.validation.AdditionalValidations; - -import javax.validation.Valid; -import javax.validation.constraints.NotNull; -import java.time.Duration; -import java.util.Collections; -import java.util.Map; - -@Data -@NoArgsConstructor -@AdditionalValidations -public class TagGuardSettings { - - private boolean enabled; - - /** - * The schedule delay for the blocking task of the {@code MeasureTagValueGuard} - */ - private Duration scheduleDelay; - - /** - * File, which contains measures with their particular recorded tags and their tag values - */ - private String databaseFile; - - /** - * String, which should be used as tag value, if the defined limit of tag values is exceeded - */ - private String overflowReplacement; - - /** - * Default max values per tag for all measures that are not specified in {@link #maxValuesPerTagByMeasure} or {@link rocks.inspectit.ocelot.config.model.metrics.definition.MetricDefinitionSettings#maxValuesPerTag}. - */ - private int maxValuesPerTag; - - /** - * Map containing max values per tag by Measure, e.g., {{'method_duration': 1337}} - *
- * max-values-per-tag-by-measure:
- * method_duration: 1337
- * http_in_responestime: 2000 - */ - @NotNull - private Map maxValuesPerTagByMeasure = Collections.emptyMap(); - -} diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/definition/MetricDefinitionSettings.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/definition/MetricDefinitionSettings.java index 62dcd4e99e..cea15ee6b2 100644 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/definition/MetricDefinitionSettings.java +++ b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/metrics/definition/MetricDefinitionSettings.java @@ -35,9 +35,6 @@ public enum MeasureType { @NotBlank private String unit; - @Builder.Default - private int maxValuesPerTag = -1; - @NotNull @Builder.Default private MetricDefinitionSettings.MeasureType type = MeasureType.DOUBLE; diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/selfmonitoring/AgentHealthSettings.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/selfmonitoring/AgentHealthSettings.java index 4449bff9ca..783c461d36 100644 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/selfmonitoring/AgentHealthSettings.java +++ b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/selfmonitoring/AgentHealthSettings.java @@ -5,7 +5,6 @@ import lombok.NonNull; import javax.validation.constraints.AssertFalse; -import javax.validation.constraints.AssertTrue; import java.time.Duration; /** @@ -22,29 +21,7 @@ public class AgentHealthSettings { @NonNull private Duration validityPeriod; - /** - * The amount of AgentHealthIncidents, which should be buffered. - */ - @NonNull - private Integer incidentBufferSize; - - /** - * The minimum delay how often the AgentHealthManager checks for invalid agent health events to clear health status. - */ - @NonNull - private Duration minHealthCheckDelay; - - @AssertTrue(message = "validityPeriod must be greater than minHealthCheckDelay!") - public boolean validityPeriodIsGreaterThanMinDelay() { - return validityPeriod.compareTo(minHealthCheckDelay) > 0; - } - - @AssertTrue(message = "minHealthCheckDelay must be at least 60 seconds!") - public boolean isMin60SecondsDelay() { - return minHealthCheckDelay.toMinutes() >= 1; - } - - @AssertFalse(message = "The specified period must not be negative!") + @AssertFalse(message = "The specified period should not be negative!") public boolean isNegativeDuration() { return validityPeriod != null && validityPeriod.isNegative(); } diff --git a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/tracing/TracingSettings.java b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/tracing/TracingSettings.java index f174b99dc9..e1529f7797 100644 --- a/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/tracing/TracingSettings.java +++ b/inspectit-ocelot-config/src/main/java/rocks/inspectit/ocelot/config/model/tracing/TracingSettings.java @@ -54,12 +54,6 @@ public enum AddCommonTags { @NotNull private AddCommonTags addCommonTags; - /** - * If enabled, metric tags will be added as attributes to tracing within the same rule - */ - @NotNull - private boolean addMetricTags; - /** * Settings for automatic tracing (stack trace sampling) */ @@ -85,7 +79,7 @@ public enum AddCommonTags { private long scheduleDelayMillis = 5000; /** - * If enabled, 64 Bit Trace Ids are used instead of the default 128 Bit. + * I enabled 64 Bit Trace Ids are used instead of the default 128 Bit. */ private boolean use64BitTraceIds = false; } diff --git a/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/basics.yml b/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/basics.yml index 986fdfe67b..c49f28ceb2 100644 --- a/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/basics.yml +++ b/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/basics.yml @@ -36,8 +36,6 @@ inspectit: # defines when to add common tags as attributes to spans # options are: NEVER, ON_GLOBAL_ROOT, ON_LOCAL_ROOT, ALWAYS add-common-tags: ON_LOCAL_ROOT - # if enabled, metric tags will be added as attributes to tracing within the same rule - add-metric-tags: true # settings regarding automatic tracing (stack-trace-sampling) auto-tracing: frequency: 50ms @@ -80,13 +78,6 @@ inspectit: # - no views and measures are created enabled: true - tag-guard: - enabled: true - max-values-per-tag: 1000 - schedule-delay: 30s - database-file : ${inspectit.env.agent-dir}/${inspectit.service-name}/tag-guard-database.json - overflow-replacement: "TAG_LIMIT_EXCEEDED" - # logging settings logging: # path to a custom user-specified logback config file that should be used diff --git a/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/self-monitoring.yml b/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/self-monitoring.yml index a4d448bc8e..5912b02f20 100644 --- a/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/self-monitoring.yml +++ b/inspectit-ocelot-config/src/main/resources/rocks/inspectit/ocelot/config/default/self-monitoring.yml @@ -15,14 +15,6 @@ inspectit: # health changes due to instrumentation errors are valid until the next re-instrumentation validity-period: 1h - # The amount of agent health incidents, which should be buffered - incident-buffer-size: 10 - - # The minimum delay how often the AgentHealthManager checks for invalid agent health events to clear health status - # By default the delay is calculated based on the last agent health event - # Minimum value is 1m - min-health-check-delay: 1m - # the action tracing mode to use # options are: OFF, ONLY_ENABLED, ALL_WITHOUT_DEFAULT, ALL_WITH_DEFAULT action-tracing: ONLY_ENABLED diff --git a/inspectit-ocelot-core/${inspectit.env.agent-dir}/InspectIT Agent/tag-guard-database.json b/inspectit-ocelot-core/${inspectit.env.agent-dir}/InspectIT Agent/tag-guard-database.json deleted file mode 100644 index 9e26dfeeb6..0000000000 --- a/inspectit-ocelot-core/${inspectit.env.agent-dir}/InspectIT Agent/tag-guard-database.json +++ /dev/null @@ -1 +0,0 @@ -{} \ No newline at end of file diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutor.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutor.java index a9c20a760f..7fc13c4034 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutor.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutor.java @@ -10,7 +10,7 @@ import rocks.inspectit.ocelot.commons.models.command.CommandResponse; import rocks.inspectit.ocelot.commons.models.command.impl.LogsCommand; import rocks.inspectit.ocelot.core.command.handler.CommandExecutor; -import rocks.inspectit.ocelot.core.selfmonitoring.logs.LogPreloader; +import rocks.inspectit.ocelot.core.selfmonitoring.LogPreloader; /** * Executor for executing {@link LogsCommand}s. diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpConfigurationPoller.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpConfigurationPoller.java index 212c0a6a1c..a3d4696cd3 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpConfigurationPoller.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpConfigurationPoller.java @@ -1,13 +1,13 @@ package rocks.inspectit.ocelot.core.config.propertysources.http; -import lombok.Getter; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.event.EventListener; import org.springframework.stereotype.Service; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthState; import rocks.inspectit.ocelot.config.model.InspectitConfig; import rocks.inspectit.ocelot.config.model.config.HttpConfigSettings; import rocks.inspectit.ocelot.core.config.InspectitEnvironment; +import rocks.inspectit.ocelot.core.selfmonitoring.event.AgentHealthChangedEvent; import rocks.inspectit.ocelot.core.service.DynamicallyActivatableService; import java.util.concurrent.ScheduledExecutorService; @@ -15,7 +15,7 @@ import java.util.concurrent.TimeUnit; /** - * Service for continuously triggering the updating of an agent configuration via HTTP. + * Service for continuously triggering the updated of a agent configuration via HTTP. */ @Service @Slf4j @@ -32,7 +32,6 @@ public class HttpConfigurationPoller extends DynamicallyActivatableService imple /** * The state of the used HTTP property source configuration. */ - @Getter private HttpPropertySourceState currentState; public HttpConfigurationPoller() { @@ -84,14 +83,10 @@ public void run() { } } - public void updateAgentHealthState(AgentHealthState agentHealth) { + @EventListener + void agentHealthChanged(AgentHealthChangedEvent event) { if (currentState != null) { - currentState.updateAgentHealthState(agentHealth); + currentState.updateAgentHealth(event.getNewHealth()); } } - - public AgentHealthState getCurrentAgentHealthState() { - if(currentState == null) return null; - return currentState.getAgentHealth(); - } } diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpPropertySourceState.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpPropertySourceState.java index 468745b10d..34219ee71b 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpPropertySourceState.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/config/propertysources/http/HttpPropertySourceState.java @@ -1,9 +1,6 @@ package rocks.inspectit.ocelot.core.config.propertysources.http; import io.github.resilience4j.retry.Retry; -import com.fasterxml.jackson.core.JsonProcessingException; -import com.fasterxml.jackson.databind.ObjectMapper; -import com.fasterxml.jackson.databind.ObjectWriter; import lombok.Getter; import lombok.NonNull; import lombok.extern.slf4j.Slf4j; @@ -22,7 +19,7 @@ import org.springframework.core.env.PropertiesPropertySource; import org.springframework.core.env.PropertySource; import rocks.inspectit.ocelot.bootstrap.AgentManager; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthState; +import rocks.inspectit.ocelot.commons.models.health.AgentHealth; import rocks.inspectit.ocelot.config.model.config.HttpConfigSettings; import rocks.inspectit.ocelot.core.config.util.InvalidPropertiesException; import rocks.inspectit.ocelot.core.config.util.PropertyUtils; @@ -104,8 +101,7 @@ public class HttpPropertySourceState { @Getter private boolean firstFileWriteAttemptSuccessful = true; - @Getter - private AgentHealthState agentHealth = AgentHealthState.defaultState(); + private AgentHealth agentHealth = AgentHealth.OK; /** * Constructor. @@ -149,7 +145,7 @@ public boolean update(boolean fallBackToFile) { * * @param newHealth The new agent health */ - public void updateAgentHealthState(@NonNull AgentHealthState newHealth) { + public void updateAgentHealth(@NonNull AgentHealth newHealth) { agentHealth = newHealth; } @@ -284,21 +280,13 @@ private String fetchConfiguration(HttpClient client, HttpGet request) throws IOE private void setAgentMetaHeaders(HttpGet httpGet) { RuntimeMXBean runtime = ManagementFactory.getRuntimeMXBean(); - ObjectWriter ow = new ObjectMapper().writer().withDefaultPrettyPrinter(); - String agentHealthJson; - try { - agentHealthJson = ow.writeValueAsString(agentHealth); - } catch (JsonProcessingException e) { - throw new RuntimeException(e); - } - httpGet.setHeader(META_HEADER_PREFIX + "AGENT-ID", runtime.getName()); httpGet.setHeader(META_HEADER_PREFIX + "AGENT-VERSION", AgentManager.getAgentVersion()); httpGet.setHeader(META_HEADER_PREFIX + "JAVA-VERSION", System.getProperty("java.version")); httpGet.setHeader(META_HEADER_PREFIX + "VM-NAME", runtime.getVmName()); httpGet.setHeader(META_HEADER_PREFIX + "VM-VENDOR", runtime.getVmVendor()); httpGet.setHeader(META_HEADER_PREFIX + "START-TIME", String.valueOf(runtime.getStartTime())); - httpGet.setHeader(META_HEADER_PREFIX + "HEALTH", agentHealthJson); + httpGet.setHeader(META_HEADER_PREFIX + "HEALTH", agentHealth.name()); httpGet.setHeader(META_HEADER_PREFIX + "SERVICE-STATES-MAP", DynamicallyActivatableServiceObserver.asJson()); } diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterService.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterService.java index 5f03a6e38c..308045565e 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterService.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterService.java @@ -34,7 +34,7 @@ public class OtlpMetricsExporterService extends DynamicallyActivatableMetricsExp /** * The {@link MetricExporter} for exporting metrics via OTLP */ - MetricExporter metricExporter; + MetricExporter metricExporter; /** * The {@link PeriodicMetricReaderBuilder} for reading metrics to the log diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/config/MethodHookConfigurationResolver.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/config/MethodHookConfigurationResolver.java index 39542655c6..6963474b18 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/config/MethodHookConfigurationResolver.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/config/MethodHookConfigurationResolver.java @@ -155,7 +155,7 @@ private void resolveEndSpan(Set matchedRules, RuleTracingSe builder.endSpan(endSpan); if (endSpan) { builder.endSpanConditions(Optional.ofNullable(getAndDetectConflicts(rulesDefiningEndSpan, r -> r.getTracing() - .getEndSpanConditions(), ALWAYS_TRUE, "end span conditions")) + .getEndSpanConditions(), ALWAYS_TRUE, "end span conditions")) .orElse(new ConditionalActionSettings())); } } diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGenerator.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGenerator.java index 140613dbd0..31246d5a1f 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGenerator.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGenerator.java @@ -23,7 +23,6 @@ import rocks.inspectit.ocelot.core.instrumentation.hook.actions.model.MetricAccessor; import rocks.inspectit.ocelot.core.instrumentation.hook.actions.span.*; import rocks.inspectit.ocelot.core.instrumentation.hook.tags.CommonTagsToAttributesManager; -import rocks.inspectit.ocelot.core.metrics.MeasureTagValueGuard; import rocks.inspectit.ocelot.core.metrics.MeasuresAndViewsManager; import rocks.inspectit.ocelot.core.opentelemetry.trace.samplers.OcelotSamplerUtils; import rocks.inspectit.ocelot.core.privacy.obfuscation.ObfuscationManager; @@ -73,9 +72,6 @@ public class MethodHookGenerator { @Autowired private ActionScopeFactory actionScopeFactory; - @Autowired - private MeasureTagValueGuard tagValueGuard; - /** * Builds an executable method hook based on the given configuration. * @@ -109,7 +105,7 @@ public MethodHook buildHook(Class declaringClass, MethodDescription method, M builder.exitActions(buildActionCalls(config.getPreExitActions(), methodInfo)); builder.exitActions(buildActionCalls(config.getExitActions(), methodInfo)); if (tracingSettings != null) { - List actions = buildTracingExitActions(config); + List actions = buildTracingExitActions(tracingSettings); if (isTracingInternalActions() && config.isTraceExitHook()) { actions = wrapActionsWithTracing(actions); } @@ -190,8 +186,7 @@ private void configureSampling(RuleTracingSettings tracing, ContinueOrStartSpanA } @VisibleForTesting - List buildTracingExitActions(MethodHookConfiguration config) { - RuleTracingSettings tracing = config.getTracing(); + List buildTracingExitActions(RuleTracingSettings tracing) { val result = new ArrayList(); boolean isSpanStartedOrContinued = tracing.getStartSpan() || StringUtils.isNotBlank(tracing.getContinueSpan()); @@ -202,24 +197,10 @@ List buildTracingExitActions(MethodHookConfiguration config) { result.add(new SetSpanStatusAction(accessor)); } - Map tracingAttributes = tracing.getAttributes(); - Map attributes = tracingAttributes; - Map constantAttributes = new HashMap<>(); - - if(addMetricsToTracing()) { - Collection metrics = config.getMetrics(); - constantAttributes = collectMetricConstantTags(metrics); - attributes = collectMetricDataTags(metrics); - // write tracing attributes after metric tags, to allow overwriting of metric tags - attributes.putAll(tracingAttributes); - } - - if (!attributes.isEmpty() || !constantAttributes.isEmpty()) { + val attributes = tracing.getAttributes(); + if (!attributes.isEmpty()) { Map attributeAccessors = new HashMap<>(); - constantAttributes.forEach((attribute, constant) -> attributeAccessors.put(attribute, variableAccessorFactory.getConstantAccessor(constant))); - // if necessary, overwrite constant attributes attributes.forEach((attribute, variable) -> attributeAccessors.put(attribute, variableAccessorFactory.getVariableAccessor(variable))); - IHookAction endTraceAction = new WriteSpanAttributesAction(attributeAccessors, obfuscationManager.obfuscatorySupplier()); IHookAction actionWithConditions = ConditionalHookAction.wrapWithConditionChecks(tracing.getAttributeConditions(), endTraceAction, variableAccessorFactory); result.add(actionWithConditions); @@ -234,25 +215,14 @@ List buildTracingExitActions(MethodHookConfiguration config) { return result; } - private Map collectMetricDataTags(Collection metrics) { - Map dataTags = new HashMap<>(); - metrics.forEach(metric -> dataTags.putAll(metric.getDataTags())); - return dataTags; - } - - private Map collectMetricConstantTags(Collection metrics) { - Map constantTags = new HashMap<>(); - metrics.forEach(metric -> constantTags.putAll(metric.getConstantTags())); - return constantTags; - } - private Optional buildMetricsRecorder(MethodHookConfiguration config) { Collection metricRecordingSettings = config.getMetrics(); if (!metricRecordingSettings.isEmpty()) { List metricAccessors = metricRecordingSettings.stream() .map(this::buildMetricAccessor) .collect(Collectors.toList()); - IHookAction recorder = new MetricsRecorder(metricAccessors, commonTagsManager, metricsManager, tagValueGuard); + + IHookAction recorder = new MetricsRecorder(metricAccessors, commonTagsManager, metricsManager); if (isTracingInternalActions() && config.isTraceExitHook()) { recorder = TracingHookAction.wrap(recorder, null, "INTERNAL"); @@ -264,13 +234,6 @@ private Optional buildMetricsRecorder(MethodHookConfiguration confi } } - /** - * @return Returns whether metrics tags should be added to tracing as attributes - */ - private boolean addMetricsToTracing() { - return environment.getCurrentConfig().getTracing().isAddMetricTags(); - } - /** * @return Returns whether action tracing should be enabled for internal actions (e.g. {@link MetricsRecorder}). */ diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorder.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorder.java index 9bcd96d6ab..b614b95db8 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorder.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorder.java @@ -1,14 +1,19 @@ package rocks.inspectit.ocelot.core.instrumentation.hook.actions; import io.opencensus.tags.TagContext; +import io.opencensus.tags.TagContextBuilder; +import io.opencensus.tags.TagKey; +import io.opencensus.tags.Tags; import lombok.Value; import lombok.extern.slf4j.Slf4j; +import rocks.inspectit.ocelot.core.instrumentation.context.InspectitContextImpl; import rocks.inspectit.ocelot.core.instrumentation.hook.actions.model.MetricAccessor; -import rocks.inspectit.ocelot.core.metrics.MeasureTagValueGuard; import rocks.inspectit.ocelot.core.metrics.MeasuresAndViewsManager; import rocks.inspectit.ocelot.core.tags.CommonTagsManager; +import rocks.inspectit.ocelot.core.tags.TagUtils; import java.util.List; +import java.util.Optional; /** * Hook action responsible for recording measurements at the exit of an instrumented method @@ -32,22 +37,46 @@ public class MetricsRecorder implements IHookAction { */ private MeasuresAndViewsManager metricsManager; - private MeasureTagValueGuard tagValueGuard; - @Override public void execute(ExecutionContext context) { // then iterate all metrics and enter new scope for metric collection for (MetricAccessor metricAccessor : metrics) { Object value = metricAccessor.getVariableAccessor().get(context); - // only record metrics where a value is present - // this allows to disable the recording of a metric depending on the results of action executions if (value instanceof Number) { - TagContext tagContext = tagValueGuard.getTagContext(context, metricAccessor); + // only record metrics where a value is present + // this allows to disable the recording of a metric depending on the results of action executions + TagContext tagContext = getTagContext(context, metricAccessor); metricsManager.tryRecordingMeasurement(metricAccessor.getName(), (Number) value, tagContext); } } } + private TagContext getTagContext(ExecutionContext context, MetricAccessor metricAccessor) { + InspectitContextImpl inspectitContext = context.getInspectitContext(); + + // create builder + TagContextBuilder builder = Tags.getTagger().emptyBuilder(); + + // first common tags to allow overwrite by constant or data tags + commonTagsManager.getCommonTagKeys() + .forEach(commonTagKey -> Optional.ofNullable(inspectitContext.getData(commonTagKey.getName())) + .ifPresent(value -> builder.putLocal(commonTagKey, TagUtils.createTagValue(commonTagKey.getName(), value + .toString())))); + + // then constant tags to allow overwrite by data + metricAccessor.getConstantTags() + .forEach((key, value) -> builder.putLocal(TagKey.create(key), TagUtils.createTagValue(key, value))); + + // go over data tags and match the value to the key from the contextTags (if available) + metricAccessor.getDataTagAccessors() + .forEach((key, accessor) -> Optional.ofNullable(accessor.get(context)) + .ifPresent(tagValue -> builder.putLocal(TagKey.create(key), TagUtils.createTagValue(key, tagValue + .toString())))); + + // build and return + return builder.build(); + } + @Override public String getName() { return "Metrics Recorder"; diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/ContinueOrStartSpanAction.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/ContinueOrStartSpanAction.java index 72cb9be2e9..41615a0149 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/ContinueOrStartSpanAction.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/ContinueOrStartSpanAction.java @@ -138,9 +138,8 @@ private void startSpan(ExecutionContext context) { hasLocalParent = !(currentSpan == Span.getInvalid() || !currentSpan.getSpanContext().isValid()); } - // This is necessary, since the lambda expression needs an effectively final value + // This is necessary, since the lambda expression needs a final value SpanContext finalRemoteParent = remoteParent; - Sampler sampler = getSampler(context); AutoCloseable spanCtx = Instances.logTraceCorrelator.startCorrelatedSpanScope(() -> stackTraceSampler.createAndEnterSpan(spanName, finalRemoteParent, sampler, spanKind, methodInfo, autoTrace)); ctx.setSpanScope(spanCtx); diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/WriteSpanAttributesAction.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/WriteSpanAttributesAction.java index 17bf86519c..a15b7cd3ce 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/WriteSpanAttributesAction.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/span/WriteSpanAttributesAction.java @@ -1,7 +1,10 @@ package rocks.inspectit.ocelot.core.instrumentation.hook.actions.span; import io.opentelemetry.api.trace.Span; -import lombok.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Singular; +import lombok.val; import rocks.inspectit.ocelot.core.instrumentation.hook.VariableAccessor; import rocks.inspectit.ocelot.core.instrumentation.hook.actions.IHookAction; import rocks.inspectit.ocelot.core.privacy.obfuscation.IObfuscatory; @@ -17,7 +20,6 @@ public class WriteSpanAttributesAction implements IHookAction { @Singular - @Getter private final Map attributeAccessors; private final Supplier obfuscatorySupplier; diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuard.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuard.java deleted file mode 100644 index c670beb445..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuard.java +++ /dev/null @@ -1,302 +0,0 @@ -package rocks.inspectit.ocelot.core.metrics; - -import com.fasterxml.jackson.core.type.TypeReference; -import com.fasterxml.jackson.databind.ObjectMapper; -import com.google.common.annotations.VisibleForTesting; -import com.google.common.collect.Maps; -import com.google.common.collect.Sets; -import io.opencensus.tags.TagContext; -import io.opencensus.tags.TagContextBuilder; -import io.opencensus.tags.TagKey; -import io.opencensus.tags.Tags; -import lombok.AllArgsConstructor; -import lombok.EqualsAndHashCode; -import lombok.NonNull; -import lombok.Value; -import lombok.extern.slf4j.Slf4j; -import org.apache.commons.lang3.StringUtils; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.stereotype.Component; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.config.model.InspectitConfig; -import rocks.inspectit.ocelot.config.model.metrics.TagGuardSettings; -import rocks.inspectit.ocelot.config.model.metrics.definition.MetricDefinitionSettings; -import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.instrumentation.context.InspectitContextImpl; -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.IHookAction; -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.model.MetricAccessor; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthManager; -import rocks.inspectit.ocelot.core.tags.CommonTagsManager; -import rocks.inspectit.ocelot.core.tags.TagUtils; - -import javax.annotation.PostConstruct; -import javax.annotation.PreDestroy; -import java.io.IOException; -import java.nio.charset.StandardCharsets; -import java.nio.file.Files; -import java.nio.file.Path; -import java.nio.file.Paths; -import java.time.Duration; -import java.util.*; -import java.util.concurrent.Future; -import java.util.concurrent.ScheduledExecutorService; -import java.util.concurrent.TimeUnit; - -@Component -@Slf4j -public class MeasureTagValueGuard { - private static final String tagOverFlowMessageTemplate = "Overflow for tag %s"; - - @Autowired - private InspectitEnvironment env; - - @Autowired - private AgentHealthManager agentHealthManager; - - /** - * Common tags manager needed for gathering common tags when recording metrics. - */ - @Autowired - private CommonTagsManager commonTagsManager; - - @Autowired - private ScheduledExecutorService executor; - - private PersistedTagsReaderWriter fileReaderWriter; - - private volatile boolean isShuttingDown = false; - - private boolean hasTagValueOverflow = false; - - /** - * Map of measure names and their related set of tag keys, which are currently blocked. - */ - private final Map> blockedTagKeysByMeasure = Maps.newHashMap(); - - private Set latestTags = Collections.synchronizedSet(new HashSet<>()); - - private Future blockTagValuesFuture; - - @PostConstruct - protected void init() { - TagGuardSettings tagGuardSettings = env.getCurrentConfig().getMetrics().getTagGuard(); - if (!tagGuardSettings.isEnabled()) return; - - fileReaderWriter = new PersistedTagsReaderWriter(tagGuardSettings.getDatabaseFile(), new ObjectMapper()); - scheduleTagGuardJob(); - - log.info(String.format("TagValueGuard started with scheduleDelay %s and database file %s", tagGuardSettings.getScheduleDelay(), tagGuardSettings.getDatabaseFile())); - } - - private void scheduleTagGuardJob() { - Duration tagGuardScheduleDelay = env.getCurrentConfig().getMetrics().getTagGuard().getScheduleDelay(); - blockTagValuesFuture = executor.schedule(blockTagValuesTask, tagGuardScheduleDelay.toNanos(), TimeUnit.NANOSECONDS); - } - - @PreDestroy - protected void stop() { - if (!env.getCurrentConfig().getMetrics().getTagGuard().isEnabled()) return; - - isShuttingDown = true; - blockTagValuesFuture.cancel(true); - } - - /** - * Task, which reads the persisted tag values to determine, which tags should be blocked, because of exceeding - * the specific tag value limit. - * If new tags values have been created, they will be persisted. - */ - @VisibleForTesting - Runnable blockTagValuesTask = () -> { - if (!env.getCurrentConfig().getMetrics().getTagGuard().isEnabled()) return; - - // read current tag value database - Map>> availableTagsByMeasure = fileReaderWriter.read(); - - Set copy = latestTags; - latestTags = Collections.synchronizedSet(new HashSet<>()); - - // process new tags - copy.forEach(tagsHolder -> { - String measureName = tagsHolder.getMeasureName(); - Map newTags = tagsHolder.getTags(); - int maxValuesPerTag = getMaxValuesPerTag(measureName, env.getCurrentConfig()); - - Map> tagValuesByTagKey = availableTagsByMeasure.computeIfAbsent(measureName, k -> Maps.newHashMap()); - newTags.forEach((tagKey, tagValue) -> { - Set tagValues = tagValuesByTagKey.computeIfAbsent(tagKey, (x) -> new HashSet<>()); - // if tag value is new AND max values per tag is already reached - if (!tagValues.contains(tagValue) && tagValues.size() >= maxValuesPerTag) { - blockedTagKeysByMeasure.computeIfAbsent(measureName, measure -> Sets.newHashSet()).add(tagKey); - agentHealthManager.notifyAgentHealth(AgentHealth.ERROR, this.getClass(), this.getClass().getName(), - String.format(tagOverFlowMessageTemplate, tagKey)); - hasTagValueOverflow = true; - } else { - tagValues.add(tagValue); - } - }); - - }); - - fileReaderWriter.write(availableTagsByMeasure); - - // remove all blocked tags, if no values are stored in the database file - if(availableTagsByMeasure.isEmpty()) blockedTagKeysByMeasure.clear(); - - // independent of processing new tags, check if tags should be blocked or unblocked due to their tag value limit - availableTagsByMeasure.forEach((measureName, tags) -> { - int maxValuesPerTag = getMaxValuesPerTag(measureName, env.getCurrentConfig()); - tags.forEach((tagKey, tagValues) -> { - if(tagValues.size() >= maxValuesPerTag) { - boolean isNewBlockedTag = blockedTagKeysByMeasure.computeIfAbsent(measureName, measure -> Sets.newHashSet()) - .add(tagKey); - if(isNewBlockedTag) { - agentHealthManager.notifyAgentHealth(AgentHealth.ERROR, this.getClass(), this.getClass().getName(), - String.format(tagOverFlowMessageTemplate, tagKey)); - hasTagValueOverflow = true; - } - } else { - blockedTagKeysByMeasure.getOrDefault(measureName, Sets.newHashSet()).remove(tagKey); - } - }); - }); - - // invalidate incident, if tag overflow was detected, but no more tags are blocked - boolean noBlockedTagKeys = blockedTagKeysByMeasure.values().stream().allMatch(Set::isEmpty); - if(hasTagValueOverflow && noBlockedTagKeys) { - agentHealthManager.invalidateIncident(this.getClass(), "Overflow for tags resolved"); - hasTagValueOverflow = false; - } - - if (!isShuttingDown) scheduleTagGuardJob(); - }; - - /** - * Gets the max value amount per tag for the given measure by hierarchically extracting - * {@link MetricDefinitionSettings#maxValuesPerTag} (prio 1), - * {@link TagGuardSettings#maxValuesPerTagByMeasure} (prio 2) and - * {@link TagGuardSettings#maxValuesPerTag} (default). - * - * @param measureName the current measure - * @return The maximum amount of tag values for the given measure - */ - @VisibleForTesting - int getMaxValuesPerTag(String measureName, InspectitConfig config) { - int maxValuesPerTag = config.getMetrics().getDefinitions().get(measureName).getMaxValuesPerTag(); - - if (maxValuesPerTag > 0) return maxValuesPerTag; - - Map maxValuesPerTagPerMeasuresMap = config.getMetrics() - .getTagGuard() - .getMaxValuesPerTagByMeasure(); - return maxValuesPerTagPerMeasuresMap.getOrDefault(measureName, config.getMetrics() - .getTagGuard() - .getMaxValuesPerTag()); - } - - /** - * Creates the full tag context, including all specified tags, for the current measure - * @param context current context - * @param metricAccessor accessor for the measure as well as the particular tags - * @return TagContext including all tags for the current measure - */ - public TagContext getTagContext(IHookAction.ExecutionContext context, MetricAccessor metricAccessor) { - Map tags = Maps.newHashMap(); - String measureName = metricAccessor.getName(); - InspectitContextImpl inspectitContext = context.getInspectitContext(); - TagGuardSettings tagGuardSettings = env.getCurrentConfig().getMetrics().getTagGuard(); - - Set blockedTagKeys = blockedTagKeysByMeasure.getOrDefault(measureName, Sets.newHashSet()); - log.debug("Currently blocked tag keys for measure {}, due to exceeding the configured tag value limit: {}", - measureName, blockedTagKeys); - - // first common tags to allow to overwrite by constant or data tags - commonTagsManager.getCommonTagKeys().forEach(commonTagKey -> { - Optional.ofNullable(inspectitContext.getData(commonTagKey.getName())) - .ifPresent(value -> tags.put(commonTagKey.getName(), TagUtils.createTagValueAsString(commonTagKey.getName(), value.toString()))); - }); - - // then constant tags to allow to overwrite by data - metricAccessor.getConstantTags().forEach((key, value) -> { - if (tagGuardSettings.isEnabled() && blockedTagKeys.contains(key)) { - String overflowReplacement = env.getCurrentConfig().getMetrics().getTagGuard().getOverflowReplacement(); - tags.put(key, TagUtils.createTagValueAsString(key, overflowReplacement)); - } else { - tags.put(key, TagUtils.createTagValueAsString(key, value)); - } - }); - - // go over data tags and match the value to the key from the contextTags (if available) - metricAccessor.getDataTagAccessors().forEach((key, accessor) -> { - if (tagGuardSettings.isEnabled() && blockedTagKeys.contains(key)) { - String overflowReplacement = env.getCurrentConfig().getMetrics().getTagGuard().getOverflowReplacement(); - tags.put(key, TagUtils.createTagValueAsString(key, overflowReplacement)); - } else { - Optional.ofNullable(accessor.get(context)) - .ifPresent(tagValue -> tags.put(key, TagUtils.createTagValueAsString(key, tagValue.toString()))); - } - }); - - TagContextBuilder tagContextBuilder = Tags.getTagger().emptyBuilder(); - tags.forEach((key, value) -> tagContextBuilder.putLocal(TagKey.create(key), TagUtils.createTagValue(key, value))); - - // store the new tags for this measure as simple object and delay traversing trough tagKeys to async job - latestTags.add(new TagsHolder(measureName, tags)); - - return tagContextBuilder.build(); - - } - - @Value - @EqualsAndHashCode - private static class TagsHolder { - - String measureName; - - Map tags; - - } - - @AllArgsConstructor - static class PersistedTagsReaderWriter { - - @NonNull - private String fileName; - - @NonNull - private ObjectMapper mapper; - - public Map>> read() { - if (!StringUtils.isBlank(fileName)) { - Path path = Paths.get(fileName); - if (Files.exists(path)) { - try { - byte[] content = Files.readAllBytes(path); - @SuppressWarnings("unchecked") Map>> tags = mapper.readValue(content, new TypeReference>>>() { - }); - return tags; - } catch (Exception e) { - log.error("Error loading tag-guard database from persistence file '{}'", fileName, e); - } - } else { - log.info("Could not find tag-guard database file. File will be created during next write"); - } - } - return Maps.newHashMap(); - } - - public void write(Map>> tagValues) { - if (!StringUtils.isBlank(fileName)) { - try { - Path path = Paths.get(fileName); - Files.createDirectories(path.getParent()); - String tagValuesString = mapper.writeValueAsString(tagValues); - Files.write(path, tagValuesString.getBytes(StandardCharsets.UTF_8)); - } catch (IOException e) { - log.error("Error writing tag-guard database to file '{}'", fileName, e); - } - } - } - } - -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBuffer.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBuffer.java deleted file mode 100644 index c15ecaba9c..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBuffer.java +++ /dev/null @@ -1,56 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring; - -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.context.ApplicationContext; -import org.springframework.stereotype.Component; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; -import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthIncidentAddedEvent; - -import java.util.*; -import java.util.concurrent.ConcurrentLinkedQueue; - -/** - * Buffer with queued AgentHealthIncidents. - * New incidents will be inserted at the beginning of the queue. - * As soon as incidents are put into a full queue, old incidents will be removed to create space - */ -@Component -public class AgentHealthIncidentBuffer { - - @Autowired - private ApplicationContext ctx; - @Autowired - private InspectitEnvironment env; - - private final ConcurrentLinkedQueue buffer = new ConcurrentLinkedQueue<>(); - - /** - * Add new incident to the buffer. - * If the buffer is full, remove the latest incident at first. - * The buffer size will be read from the current inspectIT configuration. - * @param incident new incident - */ - public void put(AgentHealthIncident incident) { - int bufferSize = env.getCurrentConfig().getSelfMonitoring().getAgentHealth().getIncidentBufferSize(); - while(buffer.size() >= bufferSize) buffer.poll(); - - buffer.offer(incident); - ctx.publishEvent(new AgentHealthIncidentAddedEvent(this, asList())); - } - - /** - * Creates a list from the internal queue. - * The list will be reversed, since the queue inserts new elements at the tail - * @return List of agent health incidents - */ - public List asList() { - List incidentList = new LinkedList<>(buffer); - Collections.reverse(incidentList); - return incidentList; - } - - public void clear() { - buffer.clear(); - } -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManager.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManager.java index fcce2277ca..bb2137a89f 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManager.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManager.java @@ -1,21 +1,21 @@ package rocks.inspectit.ocelot.core.selfmonitoring; +import ch.qos.logback.classic.spi.ILoggingEvent; import com.google.common.annotations.VisibleForTesting; +import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; -import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.ApplicationContext; import org.springframework.stereotype.Component; import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.selfmonitoring.event.listener.LogWritingHealthEventListener; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; +import rocks.inspectit.ocelot.core.logging.logback.InternalProcessingAppender; +import rocks.inspectit.ocelot.core.selfmonitoring.event.AgentHealthChangedEvent; import javax.annotation.PostConstruct; +import javax.annotation.PreDestroy; import java.time.Duration; import java.time.LocalDateTime; import java.util.Comparator; -import java.util.List; import java.util.Map; import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.ScheduledExecutorService; @@ -26,20 +26,22 @@ */ @Component @Slf4j -public class AgentHealthManager { +@RequiredArgsConstructor +public class AgentHealthManager implements InternalProcessingAppender.LogEventConsumer { - @Autowired - private ApplicationContext ctx; - @Autowired - private ScheduledExecutorService executor; - @Autowired - private InspectitEnvironment env; - @Autowired - private AgentHealthIncidentBuffer healthIncidentBuffer; + private static final String LOG_CHANGE_STATUS = "The agent status changed from {} to {}."; + + private final ApplicationContext ctx; + + private final ScheduledExecutorService executor; + + private final InspectitEnvironment env; + + private final SelfMonitoringService selfMonitoringService; /** * Map of {@code eventClass -> agentHealth}, whereas the {@code agentHealth} is reset whenever an event of type - * {@code eventClass} occurs (see {@link #onInvalidationEvent(Object)}). + * {@code eventClass} occurs (see {@link #onInvalidationEvent(Object)}. * The resulting agent health is the most severe value in the map. */ private final Map, AgentHealth> invalidatableHealth = new ConcurrentHashMap<>(); @@ -52,58 +54,85 @@ public class AgentHealthManager { private AgentHealth lastNotifiedHealth = AgentHealth.OK; - @PostConstruct - @VisibleForTesting - void startHealthCheckScheduler() { - checkHealthAndSchedule(); - } + @Override + public void onLoggingEvent(ILoggingEvent event, Class invalidator) { + if (AgentHealthManager.class.getCanonicalName().equals(event.getLoggerName())) { + // ignore own logs, which otherwise would tend to cause infinite loops + return; + } - public List getIncidentHistory() { - return healthIncidentBuffer.asList(); - } + AgentHealth eventHealth = AgentHealth.fromLogLevel(event.getLevel()); - /** - * Notifies the AgentHealthManager about an eventHealth. - * The manager determines, whether the event is invalidatable or times out. - * - * @param eventHealth health of event - * @param invalidator class, which created the invalidatable eventHealth - * @param loggerName name of the logger, who created the event - * @param message message of the event - */ - public void notifyAgentHealth(AgentHealth eventHealth, Class invalidator, String loggerName, String message) { - if (invalidator == null) - handleTimeoutHealth(eventHealth, loggerName, message); - else - handleInvalidatableHealth(eventHealth, invalidator, message); + if (invalidator == null) { + handleTimeoutHealth(eventHealth); + } else { + handleInvalidatableHealth(eventHealth, invalidator); + } + + triggerEventAndMetricIfHealthChanged(); } - private void handleInvalidatableHealth(AgentHealth eventHealth, Class invalidator, String eventMessage) { + private void handleInvalidatableHealth(AgentHealth eventHealth, Class invalidator) { invalidatableHealth.merge(invalidator, eventHealth, AgentHealth::mostSevere); - - boolean shouldCreateIncident = eventHealth.isMoreSevereOrEqualTo(AgentHealth.WARNING); - triggerAgentHealthChangedEvent(invalidator.getTypeName(), eventMessage, shouldCreateIncident); } - private void handleTimeoutHealth(AgentHealth eventHealth, String loggerName, String eventMassage) { + private void handleTimeoutHealth(AgentHealth eventHealth) { Duration validityPeriod = env.getCurrentConfig().getSelfMonitoring().getAgentHealth().getValidityPeriod(); - boolean isNotInfo = eventHealth.isMoreSevereOrEqualTo(AgentHealth.WARNING); - if (isNotInfo) { + if (eventHealth.isMoreSevereOrEqualTo(AgentHealth.WARNING)) { generalHealthTimeouts.put(eventHealth, LocalDateTime.now().plus(validityPeriod)); } - String fullEventMessage = eventMassage + ". This status is valid for " + validityPeriod; - triggerAgentHealthChangedEvent(loggerName, fullEventMessage, isNotInfo); } /** - * Invalidates an invalidatable eventHealth and creates a new AgentHealthIncident - * @param eventClass class, which created the invalidatable eventHealth - * @param eventMessage message of the event + * Returns the current agent health, which is the most severe out of instrumentation and general status. + * + * @return The current agent health */ - public void invalidateIncident(Class eventClass, String eventMessage) { - invalidatableHealth.remove(eventClass); - triggerAgentHealthChangedEvent(eventClass.getTypeName(), eventMessage); + public AgentHealth getCurrentHealth() { + AgentHealth generalHealth = generalHealthTimeouts.entrySet() + .stream() + .filter((entry) -> entry.getValue().isAfter(LocalDateTime.now())) + .map(Map.Entry::getKey) + .max(Comparator.naturalOrder()) + .orElse(AgentHealth.OK); + + AgentHealth invHealth = invalidatableHealth.values() + .stream() + .reduce(AgentHealth::mostSevere) + .orElse(AgentHealth.OK); + + return AgentHealth.mostSevere(generalHealth, invHealth); + } + + @Override + public void onInvalidationEvent(Object invalidator) { + invalidatableHealth.remove(invalidator.getClass()); + triggerEventAndMetricIfHealthChanged(); + } + + @PostConstruct + @VisibleForTesting + void registerAtAppender() { + InternalProcessingAppender.register(this); + } + + @PostConstruct + @VisibleForTesting + void startHealthCheckScheduler() { + checkHealthAndSchedule(); + } + + @PostConstruct + @VisibleForTesting + void sendInitialHealthMetric() { + selfMonitoringService.recordMeasurement("health", AgentHealth.OK.ordinal()); + } + + @PreDestroy + @VisibleForTesting + void unregisterFromAppender() { + InternalProcessingAppender.unregister(this); } /** @@ -114,87 +143,48 @@ public void invalidateIncident(Class eventClass, String eventMessage) { *
  • exists -> run until that timeout is over
    • * */ - @VisibleForTesting - void checkHealthAndSchedule() { - triggerAgentHealthChangedEvent(AgentHealthManager.class.getCanonicalName(), "Checking timed out agent healths"); + private void checkHealthAndSchedule() { + triggerEventAndMetricIfHealthChanged(); Duration validityPeriod = env.getCurrentConfig().getSelfMonitoring().getAgentHealth().getValidityPeriod(); - Duration minDelay = env.getCurrentConfig().getSelfMonitoring().getAgentHealth().getMinHealthCheckDelay(); Duration delay = generalHealthTimeouts.values() .stream() - .filter(dateTime -> dateTime.isAfter(LocalDateTime.now())) + .filter(d -> d.isAfter(LocalDateTime.now())) .max(Comparator.naturalOrder()) - .map(dateTime -> { - Duration dif = Duration.between(dateTime, LocalDateTime.now()); - if (minDelay.compareTo(dif) > 0) return minDelay; - else return dif; - }) + .map(d -> Duration.between(d, LocalDateTime.now())) .orElse(validityPeriod); executor.schedule(this::checkHealthAndSchedule, delay.toMillis(), TimeUnit.MILLISECONDS); } - /** - * Creates a new AgentHealthIncident, if specified, and also triggers an AgentHealthChangedEvent, - * if the agent health has changed - * - * @param incidentSource class, which caused the incident - * @param message message, describing the incident - * @param shouldCreateIncident whether to create a new AgentHealthIncident or not - */ - private void triggerAgentHealthChangedEvent(String incidentSource, String message, Boolean shouldCreateIncident) { - synchronized (this) { - boolean changedHealth = healthHasChanged(); - AgentHealth currentHealth = getCurrentHealth(); - - // Don't create incident for health event logs - boolean isLoggedHealthEvent = incidentSource.equals(LogWritingHealthEventListener.class.getName()); - - if(shouldCreateIncident && !isLoggedHealthEvent) { - AgentHealthIncident incident = new AgentHealthIncident( - LocalDateTime.now().toString(), currentHealth, incidentSource, message, changedHealth); - healthIncidentBuffer.put(incident); + private void triggerEventAndMetricIfHealthChanged() { + if (getCurrentHealth() != lastNotifiedHealth) { + AgentHealthChangedEvent event = null; + synchronized (this) { + AgentHealth currHealth = getCurrentHealth(); + if (currHealth != lastNotifiedHealth) { + AgentHealth lastHealth = lastNotifiedHealth; + lastNotifiedHealth = currHealth; + + selfMonitoringService.recordMeasurement("health", currHealth.ordinal()); + + event = new AgentHealthChangedEvent(this, lastHealth, currHealth); + ctx.publishEvent(event); + } } - if(changedHealth) { - AgentHealth lastHealth = lastNotifiedHealth; - lastNotifiedHealth = currentHealth; - AgentHealthChangedEvent event = new AgentHealthChangedEvent(this, lastHealth, currentHealth, message); - ctx.publishEvent(event); + // It is important that logging happens outside the synchronized block above. + // Otherwise, a deadlock may happen since _this_ is via Interface + // InternalProcessingAppender.LogEventConsumer indirectly a part of the logback infrastructure + if (event != null) { + AgentHealth newHealth = event.getNewHealth(); + AgentHealth oldHealth = event.getOldHealth(); + if(newHealth.isMoreSevereOrEqualTo(oldHealth)) { + log.warn(LOG_CHANGE_STATUS, oldHealth, newHealth); + } else { + log.info(LOG_CHANGE_STATUS, oldHealth, newHealth); + } } } } - - private void triggerAgentHealthChangedEvent(String incidentSource, String message) { - triggerAgentHealthChangedEvent(incidentSource, message, true); - } - - /** - * Checks whether the current health has changed since last check. - * - * @return true if the health state changed - */ - private boolean healthHasChanged() { - return getCurrentHealth() != lastNotifiedHealth; - } - - /** - * Returns the current agent health, which is the most severe out of instrumentation and general status. - * - * @return The current agent health - */ - public AgentHealth getCurrentHealth() { - AgentHealth generalHealth = generalHealthTimeouts.entrySet() - .stream() - .filter((entry) -> entry.getValue().isAfter(LocalDateTime.now())) - .map(Map.Entry::getKey) - .max(Comparator.naturalOrder()) - .orElse(AgentHealth.OK); - - AgentHealth invHealth = invalidatableHealth.values() - .stream() - .reduce(AgentHealth::mostSevere) - .orElse(AgentHealth.OK); - return AgentHealth.mostSevere(generalHealth, invHealth); - } } diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsRecorder.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsRecorder.java similarity index 91% rename from inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsRecorder.java rename to inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsRecorder.java index 23a5215bc0..a000c4f2e3 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsRecorder.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsRecorder.java @@ -1,10 +1,9 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; +package rocks.inspectit.ocelot.core.selfmonitoring; import ch.qos.logback.classic.spi.ILoggingEvent; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Component; import rocks.inspectit.ocelot.core.logging.logback.InternalProcessingAppender; -import rocks.inspectit.ocelot.core.selfmonitoring.SelfMonitoringService; import javax.annotation.PostConstruct; import javax.annotation.PreDestroy; diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogPreloader.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/LogPreloader.java similarity index 99% rename from inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogPreloader.java rename to inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/LogPreloader.java index 59ecee0456..a26c16455f 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogPreloader.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/LogPreloader.java @@ -1,4 +1,4 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; +package rocks.inspectit.ocelot.core.selfmonitoring; import ch.qos.logback.classic.Level; import ch.qos.logback.classic.Logger; diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthChangedEvent.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/AgentHealthChangedEvent.java similarity index 67% rename from inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthChangedEvent.java rename to inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/AgentHealthChangedEvent.java index 401ed4bef3..eb288a40c2 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthChangedEvent.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/AgentHealthChangedEvent.java @@ -1,10 +1,10 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.models; +package rocks.inspectit.ocelot.core.selfmonitoring.event; import lombok.Getter; import lombok.NonNull; import org.springframework.context.ApplicationEvent; import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.selfmonitoring.logs.LogPreloader; +import rocks.inspectit.ocelot.core.selfmonitoring.LogPreloader; /** * Fired by {@link LogPreloader} whenever the agent health changed. @@ -23,17 +23,10 @@ public class AgentHealthChangedEvent extends ApplicationEvent { @Getter private AgentHealth newHealth; - /** - * The message stating the cause of the event. - */ - @Getter - private String message; - - public AgentHealthChangedEvent(Object source, @NonNull AgentHealth oldHealth, @NonNull AgentHealth newHealth, String message) { + public AgentHealthChangedEvent(Object source, @NonNull AgentHealth oldHealth, @NonNull AgentHealth newHealth) { super(source); this.oldHealth = oldHealth; this.newHealth = newHealth; - this.message = message; } } diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/HealthEventListener.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/HealthEventListener.java deleted file mode 100644 index 20832ab049..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/HealthEventListener.java +++ /dev/null @@ -1,13 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import org.springframework.context.event.EventListener; -import org.springframework.scheduling.annotation.Async; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; - -public interface HealthEventListener { - - @Async - @EventListener - void onAgentHealthEvent(AgentHealthChangedEvent event); - -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListener.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListener.java deleted file mode 100644 index de1d1f2ec3..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListener.java +++ /dev/null @@ -1,23 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import lombok.extern.slf4j.Slf4j; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.stereotype.Component; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; - -@Component -@Slf4j -public class LogWritingHealthEventListener implements HealthEventListener { - - private static final String LOG_CHANGE_STATUS = "The agent status changed from {} to {}. Reason: {}"; - - @Override - public void onAgentHealthEvent(AgentHealthChangedEvent event) { - if (event.getNewHealth().isMoreSevereOrEqualTo(event.getOldHealth())) { - log.warn(LOG_CHANGE_STATUS, event.getOldHealth(), event.getNewHealth(), event.getMessage()); - } else { - log.info(LOG_CHANGE_STATUS, event.getOldHealth(), event.getNewHealth(), event.getMessage()); - } - - } -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListener.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListener.java deleted file mode 100644 index 02ee047c6c..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListener.java +++ /dev/null @@ -1,35 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import com.google.common.annotations.VisibleForTesting; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.stereotype.Component; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.selfmonitoring.SelfMonitoringService; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; - -import javax.annotation.PostConstruct; -import java.util.HashMap; - -@Component -public class MetricWritingHealthEventListener implements HealthEventListener { - - private static final String INITIAL_METRIC_MESSAGE = "Initial health metric sent"; - - @Autowired - private SelfMonitoringService selfMonitoringService; - - @PostConstruct - @VisibleForTesting - void sendInitialHealthMetric() { - HashMap tags = new HashMap<>(); - tags.put("message", INITIAL_METRIC_MESSAGE); - selfMonitoringService.recordMeasurement("health", AgentHealth.OK.ordinal(), tags); - } - @Override - public void onAgentHealthEvent(AgentHealthChangedEvent event) { - HashMap tags = new HashMap<>(); - tags.put("message", event.getMessage()); - tags.put("source", event.getSource().getClass().getName()); - selfMonitoringService.recordMeasurement("health", event.getNewHealth().ordinal(), tags); - } -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListener.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListener.java deleted file mode 100644 index a33028b975..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListener.java +++ /dev/null @@ -1,42 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.context.event.EventListener; -import org.springframework.scheduling.annotation.Async; -import org.springframework.stereotype.Component; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthState; -import rocks.inspectit.ocelot.core.config.propertysources.http.HttpConfigurationPoller; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthManager; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthIncidentAddedEvent; - -import java.util.List; - -@Component -public class PollerWritingHealthEventListener implements HealthEventListener { - - @Autowired - HttpConfigurationPoller httpConfigurationPoller; - - @Autowired - AgentHealthManager agentHealthManager; - - @Override - public void onAgentHealthEvent(AgentHealthChangedEvent event) { - List incidentHistory = agentHealthManager.getIncidentHistory(); - - AgentHealthState state = new AgentHealthState(event.getNewHealth(), event.getSource().toString(), event.getMessage(), incidentHistory); - httpConfigurationPoller.updateAgentHealthState(state); - } - - @Async - @EventListener - public void onAgentHealthIncidentEvent(AgentHealthIncidentAddedEvent event) { - List incidentHistory = event.getCurrentIncidents(); - AgentHealthIncident latestIncident = incidentHistory.get(0); - - AgentHealthState state = new AgentHealthState(latestIncident.getHealth(), latestIncident.getSource(), latestIncident.getMessage(), incidentHistory); - httpConfigurationPoller.updateAgentHealthState(state); - } -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthIncidentAddedEvent.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthIncidentAddedEvent.java deleted file mode 100644 index a2acba676e..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/event/models/AgentHealthIncidentAddedEvent.java +++ /dev/null @@ -1,22 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.models; - -import lombok.Getter; -import org.springframework.context.ApplicationEvent; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthIncidentBuffer; - -import java.util.List; - -/** - * Fired by {@link AgentHealthIncidentBuffer} whenever a new incident has been added. - */ -public class AgentHealthIncidentAddedEvent extends ApplicationEvent { - - @Getter - private final List currentIncidents; - - public AgentHealthIncidentAddedEvent(Object source, List currentIncidents) { - super(source); - this.currentIncidents = currentIncidents; - } -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitor.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitor.java deleted file mode 100644 index 27af2daace..0000000000 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitor.java +++ /dev/null @@ -1,51 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; - -import ch.qos.logback.classic.spi.ILoggingEvent; -import com.google.common.annotations.VisibleForTesting; -import lombok.RequiredArgsConstructor; -import lombok.extern.slf4j.Slf4j; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.stereotype.Component; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.logging.logback.InternalProcessingAppender; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthManager; - -import javax.annotation.PostConstruct; -import javax.annotation.PreDestroy; - -@Component -@Slf4j -@RequiredArgsConstructor -public class LogHealthMonitor implements InternalProcessingAppender.LogEventConsumer { - - @Autowired - final AgentHealthManager agentHealthManager; - - @Override - public void onLoggingEvent(ILoggingEvent event, Class invalidator) { - if (AgentHealthManager.class.getCanonicalName().equals(event.getLoggerName())) { - // ignore own logs, which otherwise would tend to cause infinite loops - return; - } - AgentHealth eventHealth = AgentHealth.fromLogLevel(event.getLevel()); - agentHealthManager.notifyAgentHealth(eventHealth, invalidator, event.getLoggerName(), event.getFormattedMessage()); - } - - @Override - public void onInvalidationEvent(Object invalidator) { - agentHealthManager.invalidateIncident(invalidator.getClass(), "Invalidation due to invalidator event"); - } - - @PostConstruct - @VisibleForTesting - void registerAtAppender() { - InternalProcessingAppender.register(this); - } - - @PreDestroy - @VisibleForTesting - void unregisterFromAppender() { - InternalProcessingAppender.unregister(this); - } - -} diff --git a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/tags/TagUtils.java b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/tags/TagUtils.java index e98a3714d7..86d7e045a1 100644 --- a/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/tags/TagUtils.java +++ b/inspectit-ocelot-core/src/main/java/rocks/inspectit/ocelot/core/tags/TagUtils.java @@ -5,8 +5,6 @@ import io.opencensus.tags.TagValue; import lombok.extern.slf4j.Slf4j; -import java.util.function.Function; - @Slf4j public final class TagUtils { @@ -51,19 +49,11 @@ private TagUtils() { * @return the created TagValue with 'v' or '<invalid>' */ public static TagValue createTagValue(String tagKey, String value) { - return resolveTageValue(tagKey, value, TagValue::create); - } - - public static String createTagValueAsString(String tagKey, String value) { - return resolveTageValue(tagKey, value, s -> s); - } - - private static T resolveTageValue(String tagKey, String value, Function creator) { if (isTagValueValid(value)) { - return creator.apply(value); + return TagValue.create(value); } printWarning(tagKey, value); - return creator.apply(""); + return TagValue.create(""); } private static boolean isTagValueValid(String value) { diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutorTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutorTest.java index 7c5fb01c74..f7e76a5989 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutorTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/command/handler/impl/LogsCommandExecutorTest.java @@ -18,7 +18,7 @@ import rocks.inspectit.ocelot.config.model.selfmonitoring.LogPreloadingSettings; import rocks.inspectit.ocelot.core.SpringTestBase; import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.selfmonitoring.logs.LogPreloader; +import rocks.inspectit.ocelot.core.selfmonitoring.LogPreloader; import java.io.File; import java.io.IOException; diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/ExporterServiceIntegrationTestBase.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/ExporterServiceIntegrationTestBase.java index 08f6610883..c7eecbd1b8 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/ExporterServiceIntegrationTestBase.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/ExporterServiceIntegrationTestBase.java @@ -52,19 +52,17 @@ import static org.testcontainers.Testcontainers.exposeHostPorts; /** - * Base class for exporter integration tests. Verifies integration with the OpenTelemetry Collector. - * The Collector can be configured to accept the required data over gRPC or HTTP and exports the data over gRPC - * to a server running in process, allowing assertions to be made against the data. + * Base class for exporter integration tests. Verifies integration with the OpenTelemetry Collector. The Collector can be configured to accept the required data over gRPC or HTTP and exports the data over gRPC to a server running in process, allowing assertions to be made against the data. * This class is based on the {@link io.opentelemetry.integrationtest.OtlpExporterIntegrationTest} */ @Testcontainers(disabledWithoutDocker = true) -public abstract class ExporterServiceIntegrationTestBase extends SpringTestBase { +abstract class ExporterServiceIntegrationTestBase extends SpringTestBase { static final String COLLECTOR_TAG = "0.58.0"; static final String COLLECTOR_IMAGE = "otel/opentelemetry-collector-contrib:" + COLLECTOR_TAG; - protected static final Integer COLLECTOR_OTLP_GRPC_PORT = 4317; + static final Integer COLLECTOR_OTLP_GRPC_PORT = 4317; static final Integer COLLECTOR_OTLP_HTTP_PORT = 4318; @@ -156,8 +154,7 @@ static Tracer getOtelTracer() { } /** - * Gets the desired endpoint of the {@link #collector} constructed as - * 'http://{@link GenericContainer#getHost() collector.getHost()}:{@link GenericContainer#getMappedPort(int) collector.getMappedPort(port)}/path' + * Gets the desired endpoint of the {@link #collector} constructed as 'http://{@link GenericContainer#getHost() collector.getHost()}:{@link GenericContainer#getMappedPort(int) collector.getMappedPort(port)}/path' * * @param originalPort the port to get the actual mapped port for * @param path the path @@ -169,14 +166,13 @@ static String getEndpoint(Integer originalPort, String path) { } /** - * Gets the desired endpoint of the {@link #collector} constructed as - * 'http://{@link GenericContainer#getHost() collector.getHost()}:{@link GenericContainer#getMappedPort(int) collector.getMappedPort(port)}' + * Gets the desired endpoint of the {@link #collector} constructed as 'http://{@link GenericContainer#getHost() collector.getHost()}:{@link GenericContainer#getMappedPort(int) collector.getMappedPort(port)}' * * @param originalPort the port to get the actual mapped port for * * @return the constructed endpoint for the {@link #collector} */ - protected static String getEndpoint(Integer originalPort) { + static String getEndpoint(Integer originalPort) { return String.format("http://%s:%d", collector.getHost(), collector.getMappedPort(originalPort)); } @@ -208,24 +204,23 @@ void makeSpansAndFlush(String parentSpanName, String childSpanName) { * Records some dummy metrics and flushes them. */ void recordMetricsAndFlush() { - recordMetricsAndFlush("my-counter", 1, "my-key", "my-val"); + recordMetricsAndFlush(1, "my-key", "my-val"); } /** * Records a counter with the given value and tag * - * @param measureName the name of the measure * @param value the value to add to the counter * @param tagKey the key of the tag * @param tagVal the value of the tag */ - protected void recordMetricsAndFlush(String measureName, int value, String tagKey, String tagVal) { + void recordMetricsAndFlush(int value, String tagKey, String tagVal) { // get the meter and create a counter Meter meter = GlobalOpenTelemetry.getMeterProvider() .meterBuilder("rocks.inspectit.ocelot") .setInstrumentationVersion("0.0.1") .build(); - LongCounter counter = meter.counterBuilder(measureName).setDescription("My counter").setUnit("1").build(); + LongCounter counter = meter.counterBuilder("my-counter").setDescription("My counter").setUnit("1").build(); // record counter counter.add(value, Attributes.of(AttributeKey.stringKey(tagKey), tagVal)); @@ -235,15 +230,13 @@ protected void recordMetricsAndFlush(String measureName, int value, String tagKe } /** - * Verifies that the metric with the given value and key/value attribute (tag) has been exported to and received - * by the {@link #grpcServer} + * Verifies that the metric with the given value and key/value attribute (tag) has been exported to and received by the {@link #grpcServer} * - * @param measureName the name of the measure - * @param value the value of the measure - * @param tagKey the key of the tag - * @param tagVal the value of the tag + * @param value + * @param tagKey + * @param tagVal */ - protected void awaitMetricsExported(String measureName, int value, String tagKey, String tagVal) { + void awaitMetricsExported(int value, String tagKey, String tagVal) { // create the attribute that we will use to verify that the metric has been written KeyValue attribute = KeyValue.newBuilder() .setKey(tagKey) @@ -254,11 +247,12 @@ protected void awaitMetricsExported(String measureName, int value, String tagKey .untilAsserted(() -> assertThat(grpcServer.metricRequests.stream()).anyMatch(mReq -> mReq.getResourceMetricsList() .stream() .anyMatch(rm -> - // check for the specified measure - rm.getInstrumentationLibraryMetrics(0) - .getMetricsList().stream() - .filter(metric -> metric.getName().equals(measureName)) + // check for the "my-counter" metrics + rm.getInstrumentationLibraryMetrics(0).getMetrics(0).getName().equals("my-counter") // check for the specific attribute and value + && rm.getInstrumentationLibraryMetrics(0) + .getMetricsList() + .stream() .anyMatch(metric -> metric.getSum() .getDataPointsList() .stream() @@ -267,9 +261,7 @@ protected void awaitMetricsExported(String measureName, int value, String tagKey } /** - * Waits for the spans to be exported to and received by the {@link #grpcServer}. This method asserts that Spans - * with the given names exist and that the child's {@link io.opentelemetry.proto.trace.v1.Span#getParentSpanId()} - * equals the parent's {@link io.opentelemetry.proto.trace.v1.Span#getSpanId()} + * Waits for the spans to be exported to and received by the {@link #grpcServer}. This method asserts that Spans with the given names exist and that the child's {@link io.opentelemetry.proto.trace.v1.Span#getParentSpanId()} equals the parent's {@link io.opentelemetry.proto.trace.v1.Span#getSpanId()} * * @param parentSpanName the name of the parent span * @param childSpanName the name of the child span @@ -313,7 +305,7 @@ void awaitSpansExported(String parentSpanName, String childSpanName) { /** * OpenTelemetry Protocol gRPC Server */ - public static class OtlpGrpcServer extends ServerExtension { + static class OtlpGrpcServer extends ServerExtension { final List traceRequests = new ArrayList<>(); @@ -327,10 +319,6 @@ private void reset() { logRequests.clear(); } - public List getMetricRequests() { - return metricRequests; - } - @Override protected void configure(ServerBuilder sb) { sb.service("/opentelemetry.proto.collector.trace.v1.TraceService/Export", new AbstractUnaryGrpcService() { @@ -370,8 +358,4 @@ protected CompletionStage handleMessage(ServiceRequestContext ctx, byte[ } } - public OtlpGrpcServer getGrpcServer() { - return grpcServer; - } - } diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterServiceIntTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterServiceIntTest.java index a344d4beb3..062b6d4348 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterServiceIntTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/exporter/OtlpMetricsExporterServiceIntTest.java @@ -39,10 +39,12 @@ public class OtlpMetricsExporterServiceIntTest extends ExporterServiceIntegratio @Autowired InspectitEnvironment environment; - String measure = "my-counter"; String tagKeyGrpc = "otlp-grpc-metrics-test"; + String tagKeyHttp = "otlp-grpc-metrics-test"; + String tagVal = "random-val"; + int metricVal = 1337; @BeforeEach @@ -64,9 +66,9 @@ void verifyMetricsWrittenGrpc() { .pollInterval(500, TimeUnit.MILLISECONDS) .untilAsserted(() -> assertThat(service.isEnabled()).isTrue()); - recordMetricsAndFlush(measure, metricVal, tagKeyGrpc, tagVal); + recordMetricsAndFlush(metricVal, tagKeyGrpc, tagVal); - awaitMetricsExported(measure, metricVal, tagKeyGrpc, tagVal); + awaitMetricsExported(metricVal, tagKeyGrpc, tagVal); } @DirtiesContext @@ -83,9 +85,9 @@ void verifyMetricsWrittenHttp() { .pollInterval(500, TimeUnit.MILLISECONDS) .untilAsserted(() -> assertThat(service.isEnabled()).isTrue()); - recordMetricsAndFlush(measure, metricVal, tagKeyHttp, tagVal); + recordMetricsAndFlush(metricVal, tagKeyHttp, tagVal); - awaitMetricsExported(measure, metricVal, tagKeyHttp, tagVal); + awaitMetricsExported(metricVal, tagKeyHttp, tagVal); } @@ -137,8 +139,8 @@ void testAggregationTemporalityCumulative(){ assertThat(service.isEnabled()).isTrue(); - recordMetricsAndFlush(measure, 1, "key", "val"); - recordMetricsAndFlush(measure, 2, "key", "val"); + recordMetricsAndFlush(1, "key", "val"); + recordMetricsAndFlush(2, "key", "val"); await().atMost(30, TimeUnit.SECONDS) .untilAsserted(() -> assertThat(grpcServer.metricRequests.stream()).anyMatch(mReq -> mReq.getResourceMetricsList() @@ -169,8 +171,8 @@ void testAggregationTemporalityDelta(){ assertThat(service.isEnabled()).isTrue(); - recordMetricsAndFlush(measure, 1, "key", "val"); - recordMetricsAndFlush(measure, 2, "key", "val"); + recordMetricsAndFlush(1, "key", "val"); + recordMetricsAndFlush(2, "key", "val"); await().atMost(30, TimeUnit.SECONDS) .untilAsserted(() -> assertThat(grpcServer.metricRequests.stream()).anyMatch(mReq -> mReq.getResourceMetricsList() diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGeneratorTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGeneratorTest.java index 5f643586ca..970b7c84bf 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGeneratorTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/MethodHookGeneratorTest.java @@ -1,8 +1,6 @@ package rocks.inspectit.ocelot.core.instrumentation.hook; -import com.google.common.collect.HashMultiset; import com.google.common.collect.ImmutableMap; -import com.google.common.collect.Multiset; import net.bytebuddy.description.method.MethodDescription; import net.bytebuddy.description.type.TypeDescription; import org.assertj.core.api.Assertions; @@ -29,8 +27,8 @@ import rocks.inspectit.ocelot.core.selfmonitoring.ActionScopeFactory; import rocks.inspectit.ocelot.core.testutils.Dummy; -import java.util.*; -import java.util.stream.Collectors; +import java.util.Collections; +import java.util.List; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.entry; @@ -192,8 +190,7 @@ public void verifyNoActionsGeneratedIfNoSpanStartedOrContinued() { .endSpan(true) .build(); - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(settings).build(); - List actions = generator.buildTracingExitActions(config); + List actions = generator.buildTracingExitActions(settings); assertThat(actions).isEmpty(); } @@ -208,8 +205,7 @@ public void verifyActionsGeneratedIfSpanStarted() { .endSpan(true) .build(); - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(settings).build(); - List actions = generator.buildTracingExitActions(config); + List actions = generator.buildTracingExitActions(settings); assertThat(actions) .hasSize(3) @@ -228,8 +224,7 @@ public void verifyActionsGeneratedIfSpanContinued() { .endSpan(true) .build(); - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(settings).build(); - List actions = generator.buildTracingExitActions(config); + List actions = generator.buildTracingExitActions(settings); assertThat(actions) .hasSize(3) @@ -239,240 +234,4 @@ public void verifyActionsGeneratedIfSpanContinued() { } } - - @Nested - class collectMetricTagsInTracing { - - private RuleTracingSettings createTracingSettings(Map attributes) { - return RuleTracingSettings.builder() - .startSpan(true) - .continueSpan(null) - .attributes(attributes) - .endSpan(true) - .build(); - } - - private MetricRecordingSettings createMetricSettings(Map dataTags, Map constantTags) { - return MetricRecordingSettings.builder().metric("name").value("1.0") - .dataTags(dataTags).constantTags(constantTags).build(); - } - - @Test - public void verifyTagsHaveBeenAdded() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(true); - VariableAccessor tracingAccessor = (context) -> "tracing-text"; - VariableAccessor dataAccessor = (context) -> "data-text"; - VariableAccessor constantAccessor = (context) -> "constant-text"; - when(variableAccessorFactory.getVariableAccessor("tracing-value")).thenReturn(tracingAccessor); - when(variableAccessorFactory.getVariableAccessor("data-value")).thenReturn(dataAccessor); - when(variableAccessorFactory.getConstantAccessor(any())).thenReturn(constantAccessor); - Map expectedResult = new HashMap<>(); - expectedResult.put("tracing-key", tracingAccessor); - expectedResult.put("data-tag", dataAccessor); - expectedResult.put("constant-tag", constantAccessor); - - Map attributes = ImmutableMap.of("tracing-key", "tracing-value"); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags = ImmutableMap.of("data-tag", "data-value"); - Map constantTags = ImmutableMap.of("constant-tag", "constant-value"); - MetricRecordingSettings metric = createMetricSettings(dataTags, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - - @Test - public void verifyNoTagsHaveBeenAdded() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(false); - VariableAccessor tracingAccessor = (context) -> "tracing-text"; - when(variableAccessorFactory.getVariableAccessor("tracing-value")).thenReturn(tracingAccessor); - Map expectedResult = new HashMap<>(); - expectedResult.put("tracing-key", tracingAccessor); - - Map attributes = ImmutableMap.of("tracing-key", "tracing-value"); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags = ImmutableMap.of("data-tag", "data-value"); - Map constantTags = ImmutableMap.of("constant-tag", "constant-value"); - MetricRecordingSettings metric = createMetricSettings(dataTags, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - - @Test - void verifyTracingOverwritesMetrics() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(true); - VariableAccessor tracingAccessor = (context) -> "tracing-text"; - when(variableAccessorFactory.getVariableAccessor("tracing-value")).thenReturn(tracingAccessor); - Map expectedResult = new HashMap<>(); - expectedResult.put("one-key", tracingAccessor); - - Map attributes = ImmutableMap.of("one-key", "tracing-value"); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags = ImmutableMap.of("one-key", "data-value"); - Map constantTags = ImmutableMap.of("one-key", "constant-value"); - MetricRecordingSettings metric = createMetricSettings(dataTags, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - - @Test - void verifyDataTagsOverwriteConstantTags() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(true); - VariableAccessor dataAccessor = (context) -> "data-text"; - when(variableAccessorFactory.getVariableAccessor("data-value")).thenReturn(dataAccessor); - Map expectedResult = new HashMap<>(); - expectedResult.put("one-key", dataAccessor); - - Map attributes = Collections.emptyMap(); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags = ImmutableMap.of("one-key", "data-value"); - Map constantTags = ImmutableMap.of("one-key", "constant-value"); - MetricRecordingSettings metric = createMetricSettings(dataTags, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - - @Test - void verifyOnlyDataTags() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(true); - VariableAccessor dataAccessor = (context) -> "data-text"; - when(variableAccessorFactory.getVariableAccessor("data-value")).thenReturn(dataAccessor); - Map expectedResult = new HashMap<>(); - expectedResult.put("data-tag", dataAccessor); - - Map attributes = Collections.emptyMap(); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags = ImmutableMap.of("data-tag", "data-value"); - Map constantTags = Collections.emptyMap(); - MetricRecordingSettings metric = createMetricSettings(dataTags, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - - @Test - void verifyOnlyConstantTags() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(true); - VariableAccessor constantAccessor = (context) -> "constant-text"; - when(variableAccessorFactory.getConstantAccessor(any())).thenReturn(constantAccessor); - Map expectedResult = new HashMap<>(); - expectedResult.put("constant-tag", constantAccessor); - - Map attributes = Collections.emptyMap(); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags = Collections.emptyMap(); - Map constantTags = ImmutableMap.of("constant-tag", "constant-value"); - MetricRecordingSettings metric = createMetricSettings(dataTags, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - - @Test - void verifyTagsOfMultipleMetrics() { - when(environment.getCurrentConfig().getTracing().isAddMetricTags()).thenReturn(true); - VariableAccessor tracingAccessor = (context) -> "tracing-text"; - VariableAccessor dataAccessor1 = (context) -> "data-text-1"; - VariableAccessor dataAccessor2 = (context) -> "data-text-2"; - when(variableAccessorFactory.getVariableAccessor("tracing-value")).thenReturn(tracingAccessor); - when(variableAccessorFactory.getVariableAccessor("data-value-1")).thenReturn(dataAccessor1); - when(variableAccessorFactory.getVariableAccessor("data-value-2")).thenReturn(dataAccessor2); - Map expectedResult = new HashMap<>(); - expectedResult.put("tracing-key", tracingAccessor); - expectedResult.put("data-tag-1", dataAccessor1); - expectedResult.put("data-tag-2", dataAccessor2); - - Map attributes = ImmutableMap.of("tracing-key", "tracing-value"); - RuleTracingSettings tracing = createTracingSettings(attributes); - - Map dataTags1 = ImmutableMap.of("data-tag-1", "data-value-1"); - Map dataTags2 = ImmutableMap.of("data-tag-2", "data-value-2"); - Map constantTags = Collections.emptyMap(); - MetricRecordingSettings metric1 = createMetricSettings(dataTags1, constantTags); - MetricRecordingSettings metric2 = createMetricSettings(dataTags2, constantTags); - Multiset metrics = HashMultiset.create(); - metrics.add(metric1); - metrics.add(metric2); - - MethodHookConfiguration config = MethodHookConfiguration.builder().tracing(tracing).metrics(metrics).build(); - List actions = generator.buildTracingExitActions(config); - - Optional maybeAction = actions.stream().filter(action -> action instanceof WriteSpanAttributesAction).findFirst(); - assertThat(maybeAction.isPresent()).isTrue(); - WriteSpanAttributesAction attributeAction = (WriteSpanAttributesAction) maybeAction.get(); - - Map accessors = attributeAction.getAttributeAccessors(); - assertThat(accessors.size()).isEqualTo(expectedResult.size()); - assertThat(accessors).containsAllEntriesOf(expectedResult); - } - } } diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorderTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorderTest.java index c67ff2dbd5..926e5eeb5d 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorderTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/instrumentation/hook/actions/MetricsRecorderTest.java @@ -8,14 +8,13 @@ import org.junit.jupiter.api.Nested; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.*; +import org.mockito.InOrder; +import org.mockito.Mock; +import org.mockito.Mockito; import org.mockito.junit.jupiter.MockitoExtension; -import rocks.inspectit.ocelot.core.SpringTestBase; -import rocks.inspectit.ocelot.core.config.InspectitEnvironment; import rocks.inspectit.ocelot.core.instrumentation.context.InspectitContextImpl; import rocks.inspectit.ocelot.core.instrumentation.hook.VariableAccessor; import rocks.inspectit.ocelot.core.instrumentation.hook.actions.model.MetricAccessor; -import rocks.inspectit.ocelot.core.metrics.MeasureTagValueGuard; import rocks.inspectit.ocelot.core.metrics.MeasuresAndViewsManager; import rocks.inspectit.ocelot.core.tags.CommonTagsManager; @@ -27,7 +26,7 @@ import static org.mockito.Mockito.*; @ExtendWith(MockitoExtension.class) -public class MetricsRecorderTest extends SpringTestBase { +public class MetricsRecorderTest { @Mock CommonTagsManager commonTagsManager; @@ -38,16 +37,9 @@ public class MetricsRecorderTest extends SpringTestBase { @Mock IHookAction.ExecutionContext executionContext; - @Spy - @InjectMocks - MeasureTagValueGuard tagValueGuard; - @Mock InspectitContextImpl inspectitContext; - @Mock(answer = Answers.RETURNS_DEEP_STUBS) - private InspectitEnvironment environment; - @BeforeEach void setupMock() { when(commonTagsManager.getCommonTagKeys()).thenReturn(Collections.emptyList()); @@ -61,8 +53,9 @@ class Execute { void verifyNullValueDataMetricIgnored() { VariableAccessor variableAccess = Mockito.mock(VariableAccessor.class); when(variableAccess.get(any())).thenReturn(null); - MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections.emptyMap()); - MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager, tagValueGuard); + MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections + .emptyMap()); + MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager); rec.execute(executionContext); @@ -85,10 +78,12 @@ void verifyInvalidDataTypeHandled() { VariableAccessor dataB = Mockito.mock(VariableAccessor.class); when(dataA.get(any())).thenReturn(100.0); when(dataB.get(any())).thenReturn("notanumber"); - MetricAccessor metricAccessorA = new MetricAccessor("my_metric1", dataA, Collections.emptyMap(), Collections.emptyMap()); - MetricAccessor metricAccessorB = new MetricAccessor("my_metric2", dataB, Collections.emptyMap(), Collections.emptyMap()); + MetricAccessor metricAccessorA = new MetricAccessor("my_metric1", dataA, Collections.emptyMap(), Collections + .emptyMap()); + MetricAccessor metricAccessorB = new MetricAccessor("my_metric2", dataB, Collections.emptyMap(), Collections + .emptyMap()); - MetricsRecorder rec = new MetricsRecorder(Arrays.asList(metricAccessorA, metricAccessorB), commonTagsManager, metricsManager, tagValueGuard); + MetricsRecorder rec = new MetricsRecorder(Arrays.asList(metricAccessorA, metricAccessorB), commonTagsManager, metricsManager); rec.execute(executionContext); @@ -115,8 +110,9 @@ void commonTagsIncluded() { VariableAccessor variableAccess = Mockito.mock(VariableAccessor.class); when(variableAccess.get(any())).thenReturn(100L); - MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections.emptyMap()); - MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager, tagValueGuard); + MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections + .emptyMap()); + MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager); rec.execute(executionContext); @@ -133,8 +129,9 @@ void constantTags() { VariableAccessor variableAccess = Mockito.mock(VariableAccessor.class); when(variableAccess.get(any())).thenReturn(100L); - MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.singletonMap("constant", "tag"), Collections.emptyMap()); - MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager, tagValueGuard); + MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.singletonMap("constant", "tag"), Collections + .emptyMap()); + MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager); rec.execute(executionContext); @@ -153,8 +150,9 @@ void dataTagsNotAvailable() { VariableAccessor variableAccess = Mockito.mock(VariableAccessor.class); when(variableAccess.get(any())).thenReturn(100L); - MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections.singletonMap("data", mockAccessor)); - MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager, tagValueGuard); + MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections + .singletonMap("data", mockAccessor)); + MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager); rec.execute(executionContext); @@ -171,8 +169,9 @@ void dataTags() { VariableAccessor variableAccess = Mockito.mock(VariableAccessor.class); when(variableAccess.get(any())).thenReturn(100L); - MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections.singletonMap("data", mockAccessor)); - MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager, tagValueGuard); + MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.emptyMap(), Collections + .singletonMap("data", mockAccessor)); + MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager); rec.execute(executionContext); @@ -208,22 +207,20 @@ void multipleAccessorsMixedTags() { dataTags2.put("existing2", mockAccessorC); MetricAccessor metricAccessorB = new MetricAccessor("my_metric2", dataB, Collections.singletonMap("cA", "200"), dataTags2); - MetricsRecorder rec = new MetricsRecorder(Arrays.asList(metricAccessorA, metricAccessorB), commonTagsManager, metricsManager, tagValueGuard); + MetricsRecorder rec = new MetricsRecorder(Arrays.asList(metricAccessorA, metricAccessorB), commonTagsManager, metricsManager); rec.execute(executionContext); InOrder inOrder = inOrder(metricsManager); // first recording - TagContext expected1 = Tags.getTagger() - .emptyBuilder() + TagContext expected1 = Tags.getTagger().emptyBuilder() .putLocal(TagKey.create("cA"), TagValue.create("100")) .putLocal(TagKey.create("existing"), TagValue.create("data1")) .build(); inOrder.verify(metricsManager) .tryRecordingMeasurement(eq("my_metric1"), eq((Number) 100.0d), eq(expected1)); // second recording - TagContext expected2 = Tags.getTagger() - .emptyBuilder() + TagContext expected2 = Tags.getTagger().emptyBuilder() .putLocal(TagKey.create("cA"), TagValue.create("200")) .putLocal(TagKey.create("existing1"), TagValue.create("12")) .putLocal(TagKey.create("existing2"), TagValue.create("false")) @@ -242,8 +239,9 @@ void dataOverwritesConstant() { VariableAccessor variableAccess = Mockito.mock(VariableAccessor.class); when(variableAccess.get(any())).thenReturn(100L); - MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.singletonMap("data", "constant"), Collections.singletonMap("data", mockAccessor)); - MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager, tagValueGuard); + MetricAccessor metricAccessor = new MetricAccessor("my_metric", variableAccess, Collections.singletonMap("data", "constant"), Collections + .singletonMap("data", mockAccessor)); + MetricsRecorder rec = new MetricsRecorder(Collections.singletonList(metricAccessor), commonTagsManager, metricsManager); rec.execute(executionContext); diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/logging/logback/InternalProcessingAppenderTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/logging/logback/InternalProcessingAppenderTest.java index 7fa28dc987..11cb8e6c65 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/logging/logback/InternalProcessingAppenderTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/logging/logback/InternalProcessingAppenderTest.java @@ -11,7 +11,7 @@ import org.slf4j.LoggerFactory; import rocks.inspectit.ocelot.core.instrumentation.InstrumentationManager; import rocks.inspectit.ocelot.core.instrumentation.config.event.InstrumentationConfigurationChangedEvent; -import rocks.inspectit.ocelot.core.selfmonitoring.logs.LogMetricsRecorderTest; +import rocks.inspectit.ocelot.core.selfmonitoring.LogMetricsRecorderTest; import static org.mockito.Mockito.*; diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardIntTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardIntTest.java deleted file mode 100644 index 99f5167390..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardIntTest.java +++ /dev/null @@ -1,113 +0,0 @@ -package rocks.inspectit.ocelot.core.metrics; - -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.Test; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.test.annotation.DirtiesContext; -import rocks.inspectit.ocelot.config.model.exporters.ExporterEnabledState; -import rocks.inspectit.ocelot.config.model.exporters.TransportProtocol; -import rocks.inspectit.ocelot.config.model.metrics.MetricsSettings; -import rocks.inspectit.ocelot.config.model.metrics.definition.MetricDefinitionSettings; -import rocks.inspectit.ocelot.config.model.metrics.definition.MetricDefinitionSettings.MeasureType; -import rocks.inspectit.ocelot.config.model.metrics.definition.ViewDefinitionSettings; -import rocks.inspectit.ocelot.config.model.metrics.definition.ViewDefinitionSettings.Aggregation; -import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.exporter.ExporterServiceIntegrationTestBase; -import rocks.inspectit.ocelot.core.instrumentation.config.model.propagation.PropagationMetaData; -import rocks.inspectit.ocelot.core.instrumentation.context.InspectitContextImpl; -import rocks.inspectit.ocelot.core.instrumentation.hook.VariableAccessor; -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.IHookAction.ExecutionContext; -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.MetricsRecorder; -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.model.MetricAccessor; -import rocks.inspectit.ocelot.core.metrics.percentiles.PercentileViewManager; -import rocks.inspectit.ocelot.core.tags.CommonTagsManager; - -import java.time.Duration; -import java.util.*; - -/** - * Integration Test Class for {@link MeasureTagValueGuard} - */ -@DirtiesContext -public class MeasureTagValueGuardIntTest extends ExporterServiceIntegrationTestBase { - - @Autowired - InspectitEnvironment env; - @Autowired - CommonTagsManager commonTagsManager; - @Autowired - MeasuresAndViewsManager metricsManager; - @Autowired - MeasureTagValueGuard tagValueGuard; - @Autowired - PercentileViewManager percentileViewManager; - - static final String MEASURE_NAME = "my-counter"; - static final int VALUE = 42; - static final String TAG_KEY = "test-tag-key"; - static final String TAG_VALUE_1 = "test-tag-value-1"; - static final String TAG_VALUE_2 = "test-tag-value-2"; - static final String OVERFLOW = "overflow"; - - private ExecutionContext createExecutionContext() { - InspectitContextImpl ctx = InspectitContextImpl.createFromCurrent(new HashMap<>(), PropagationMetaData.builder().build(), false); - return new ExecutionContext(null, this, "return", null, null, - ctx, null); - } - - /** - * Update properties for OpenTelemetry-Collector & Tag-Guard - * Create metric-definition for MEASURE_NAME - */ - @BeforeEach - void updateProperties() { - ViewDefinitionSettings viewDefinition = new ViewDefinitionSettings(); - viewDefinition.setAggregation(Aggregation.SUM); - viewDefinition.setTags(Collections.singletonMap(TAG_KEY, true)); - - MetricDefinitionSettings metricDefinition = new MetricDefinitionSettings(); - metricDefinition.setEnabled(true); - metricDefinition.setUnit("1"); - metricDefinition.setType(MeasureType.LONG); - metricDefinition.setViews(Collections.singletonMap(MEASURE_NAME, viewDefinition)); - - MetricsSettings metricsSettings = new MetricsSettings(); - metricsSettings.setDefinitions(Collections.singletonMap(MEASURE_NAME, metricDefinition)); - - updateProperties(mps -> { - mps.setProperty("inspectit.exporters.metrics.otlp.endpoint", getEndpoint(COLLECTOR_OTLP_GRPC_PORT)); - mps.setProperty("inspectit.exporters.metrics.otlp.export-interval", "500ms"); - mps.setProperty("inspectit.exporters.metrics.otlp.enabled", ExporterEnabledState.ENABLED); - mps.setProperty("inspectit.exporters.metrics.otlp.protocol", TransportProtocol.GRPC); - mps.setProperty("inspectit.metrics.tag-guard.enabled", true); - mps.setProperty("inspectit.metrics.tag-guard.max-values-per-tag", 1); - mps.setProperty("inspectit.metrics.tag-guard.schedule-delay", Duration.ofMillis(500)); - mps.setProperty("inspectit.metrics.tag-guard.overflow-replacement", OVERFLOW); - mps.setProperty("inspectit.metrics.definitions." + MEASURE_NAME, metricDefinition); - }); - } - - @Test - void verifyTagValueOverflowReplacement() { - VariableAccessor variableAccessor = (context) -> VALUE; - Map dataTags = new HashMap<>(); - dataTags.put(TAG_KEY, (context) -> TAG_VALUE_1); - MetricAccessor metricAccessor = new MetricAccessor(MEASURE_NAME, variableAccessor, new HashMap<>(), dataTags); - List metrics = new LinkedList<>(); - metrics.add(metricAccessor); - - MetricsRecorder metricsRecorder = new MetricsRecorder(metrics, commonTagsManager, metricsManager, tagValueGuard); - ExecutionContext executionContext = createExecutionContext(); - - metricsRecorder.execute(executionContext); - awaitMetricsExported(MEASURE_NAME, VALUE, TAG_KEY, TAG_VALUE_1); - - // for some reason, the ScheduledExecutorService is not working inside tests - tagValueGuard.blockTagValuesTask.run(); - - dataTags.put(TAG_KEY, (context) -> TAG_VALUE_2); - metricsRecorder.execute(executionContext); - // tag should have been replaced, due to overflow - awaitMetricsExported(MEASURE_NAME, VALUE, TAG_KEY, OVERFLOW); - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardTest.java deleted file mode 100644 index d26b4b00c9..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/metrics/MeasureTagValueGuardTest.java +++ /dev/null @@ -1,302 +0,0 @@ -package rocks.inspectit.ocelot.core.metrics; - -import com.fasterxml.jackson.databind.ObjectMapper; -import com.google.common.collect.Maps; -import io.opencensus.tags.TagContext; -import io.opencensus.tags.TagKey; -import io.opencensus.tags.TagValue; -import io.opencensus.tags.Tags; -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.Nested; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.Answers; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.Mockito; -import org.mockito.junit.jupiter.MockitoExtension; -import rocks.inspectit.ocelot.config.model.metrics.TagGuardSettings; -import rocks.inspectit.ocelot.config.model.metrics.definition.MetricDefinitionSettings; -import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.instrumentation.config.model.propagation.PropagationMetaData; -import rocks.inspectit.ocelot.core.instrumentation.context.InspectitContextImpl; -import rocks.inspectit.ocelot.core.instrumentation.hook.VariableAccessor; -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.IHookAction.ExecutionContext; - -import rocks.inspectit.ocelot.core.instrumentation.hook.actions.model.MetricAccessor; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthManager; -import rocks.inspectit.ocelot.core.tags.CommonTagsManager; - -import java.io.IOException; -import java.nio.file.Files; -import java.nio.file.Path; -import java.time.Duration; -import java.util.*; -import java.util.concurrent.ScheduledExecutorService; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.mockito.Mockito.when; - -@ExtendWith(MockitoExtension.class) -class MeasureTagValueGuardTest { - - @Mock(answer = Answers.RETURNS_DEEP_STUBS) - private InspectitEnvironment environment; - @Mock - private CommonTagsManager commonTagsManager; - @Mock - private AgentHealthManager agentHealthManager; - @Mock - private ScheduledExecutorService executor; - @Mock - MeasureTagValueGuard.PersistedTagsReaderWriter readerWriter; - @InjectMocks - private MeasureTagValueGuard guard = new MeasureTagValueGuard(); - - private ExecutionContext context; - private final static int defaultMaxValuePerTag = 42; - private final static String OVERFLOW = "overflow"; - - /** - * Helper method to configure tag value limits as well as metrics settings before testing - * @param maxValuesPerTagByMeasure Map with measures and their tag value limits - * @param settings MetricDefinitionSettings, which should be applied for "measure" - */ - private void setupTagGuard(Map maxValuesPerTagByMeasure, MetricDefinitionSettings settings) { - TagGuardSettings tagGuardSettings = new TagGuardSettings(); - tagGuardSettings.setEnabled(true); - tagGuardSettings.setScheduleDelay(Duration.ofSeconds(1)); - tagGuardSettings.setOverflowReplacement(OVERFLOW); - tagGuardSettings.setMaxValuesPerTag(defaultMaxValuePerTag); - if (maxValuesPerTagByMeasure != null) - tagGuardSettings.setMaxValuesPerTagByMeasure(maxValuesPerTagByMeasure); - - when(environment.getCurrentConfig().getMetrics().getTagGuard()).thenReturn(tagGuardSettings); - - if (settings != null) - when(environment.getCurrentConfig() - .getMetrics() - .getDefinitions() - .get("measure")).thenReturn(settings); - } - - @Nested - public class ReaderWrite { - - private String generateTempFilePath() { - try { - Path tempFile = Files.createTempFile("inspectit", ""); - System.out.println(tempFile); - Files.delete(tempFile); - tempFile.toFile().deleteOnExit(); - return tempFile.toString(); - } catch (IOException e) { - throw new RuntimeException(e); - } - } - - private Map>> createTagValues() { - Set tagValue = new HashSet<>(); - tagValue.add("value1"); - tagValue.add("value2"); - tagValue.add("value3"); - - Map> tagKeys2Values = Maps.newHashMap(); - tagKeys2Values.put("tagKey_1", tagValue); - - Map>> measure2TagKeys = Maps.newHashMap(); - measure2TagKeys.put("measure_1", tagKeys2Values); - - return measure2TagKeys; - } - - @Test - public void testReadWriteTagsFromDisk() { - String tempFileName = generateTempFilePath(); - - MeasureTagValueGuard.PersistedTagsReaderWriter readerWriter = new MeasureTagValueGuard.PersistedTagsReaderWriter(tempFileName, new ObjectMapper()); - Map>> tagValues = createTagValues(); - readerWriter.write(tagValues); - Map>> loaded = readerWriter.read(); - - assertThat(loaded).flatExtracting("measure_1") - .flatExtracting("tagKey_1") - .containsExactlyInAnyOrder("value1", "value2", "value3"); - - } - } - - @Nested - public class getMaxValuesPerTag { - - @Test - public void getMaxValuesPerTagByDefault() { - setupTagGuard(null, null); - - assertThat(guard.getMaxValuesPerTag("measure", environment.getCurrentConfig())).isEqualTo(defaultMaxValuePerTag); - } - - @Test - public void getMaxValuesPerTagByMeasure() { - Map maxValuesPerTagByMeasure = new HashMap<>(); - maxValuesPerTagByMeasure.put("measure", 43); - setupTagGuard(maxValuesPerTagByMeasure, null); - - assertThat(guard.getMaxValuesPerTag("measure", environment.getCurrentConfig())).isEqualTo(43); - assertThat(guard.getMaxValuesPerTag("measure1", environment.getCurrentConfig())).isEqualTo(defaultMaxValuePerTag); - } - - @Test - public void getMaxValuesPerTagByMetricDefinitionSettings() { - MetricDefinitionSettings settings = new MetricDefinitionSettings(); - settings.setMaxValuesPerTag(43); - setupTagGuard(null, settings); - - assertThat(guard.getMaxValuesPerTag("measure", environment.getCurrentConfig())).isEqualTo(43); - assertThat(guard.getMaxValuesPerTag("measure1", environment.getCurrentConfig())).isEqualTo(defaultMaxValuePerTag); - } - - @Test - public void getMaxValuesPerTagWhenAllSettingsAreSet() { - Map maxValuesPerTagByMeasure = new HashMap<>(); - maxValuesPerTagByMeasure.put("measure", 43); - maxValuesPerTagByMeasure.put("measure2", 48); - - MetricDefinitionSettings settings = new MetricDefinitionSettings(); - settings.setMaxValuesPerTag(44); - - setupTagGuard(maxValuesPerTagByMeasure, settings); - - assertThat(guard.getMaxValuesPerTag("measure", environment.getCurrentConfig())).isEqualTo(44); - assertThat(guard.getMaxValuesPerTag("measure2", environment.getCurrentConfig())).isEqualTo(48); - assertThat(guard.getMaxValuesPerTag("measure3", environment.getCurrentConfig())).isEqualTo(defaultMaxValuePerTag); - } - } - - @Nested - public class getTagContext { - - static final String TAG_KEY = "test-tag-key"; - static final String TAG_VALUE_1 = "test-tag-value-1"; - static final String TAG_VALUE_2 = "test-tag-value-2"; - private MetricAccessor metricAccessor1; - private MetricAccessor metricAccessor2; - - private ExecutionContext createExecutionContext() { - InspectitContextImpl ctx = InspectitContextImpl.createFromCurrent(new HashMap<>(), PropagationMetaData.builder().build(), false); - return new ExecutionContext(null, this, "return", null, null, - ctx, null); - } - - @BeforeEach - void setUp() { - VariableAccessor metricValueAccess = Mockito.mock(VariableAccessor.class); - metricAccessor1 = new MetricAccessor("measure", metricValueAccess, Collections.emptyMap(), - Collections.singletonMap(TAG_KEY, (context) -> TAG_VALUE_1)); - metricAccessor2 = new MetricAccessor("measure", metricValueAccess, Collections.emptyMap(), - Collections.singletonMap(TAG_KEY, (context) -> TAG_VALUE_2)); - - context = createExecutionContext(); - - when(readerWriter.read()).thenReturn(new HashMap<>()); - when(commonTagsManager.getCommonTagKeys()).thenReturn(Collections.emptyList()); - } - - @Test - void verifyOverflow() { - Map maxValuesPerTagByMeasure = new HashMap<>(); - maxValuesPerTagByMeasure.put("measure", 1); - setupTagGuard(maxValuesPerTagByMeasure, null); - - TagContext expectedTagContext = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(TAG_VALUE_1)) - .build(); - - TagContext expectedOverflow = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(OVERFLOW)) - .build(); - - // first tag value should be accepted - TagContext tagContext = guard.getTagContext(context, metricAccessor1); - guard.blockTagValuesTask.run(); - // second tag value will exceed the limit - TagContext overflow = guard.getTagContext(context, metricAccessor2); - - assertThat(tagContext.equals(expectedTagContext)).isTrue(); - assertThat(overflow.equals(expectedOverflow)).isTrue(); - } - - @Test - void verifyOverflowResolvedAfterLimitIncrease() { - Map maxValuesPerTagByMeasure = new HashMap<>(); - maxValuesPerTagByMeasure.put("measure", 1); - setupTagGuard(maxValuesPerTagByMeasure, null); - - TagContext expectedTagContext1 = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(TAG_VALUE_1)) - .build(); - - TagContext expectedTagContext2 = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(TAG_VALUE_2)) - .build(); - - TagContext expectedOverflow = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(OVERFLOW)) - .build(); - - // first tag value should be accepted - TagContext tagContext1 = guard.getTagContext(context, metricAccessor1); - guard.blockTagValuesTask.run(); - // second tag value will exceed the limit - TagContext overflow = guard.getTagContext(context, metricAccessor2); - // increase tag limit to resolve overflow - maxValuesPerTagByMeasure.put("measure", 5); - setupTagGuard(maxValuesPerTagByMeasure, null); - guard.blockTagValuesTask.run(); - // second tag value should be accepted - TagContext tagContext2 = guard.getTagContext(context, metricAccessor2); - - assertThat(tagContext1.equals(expectedTagContext1)).isTrue(); - assertThat(overflow.equals(expectedOverflow)).isTrue(); - assertThat(tagContext2.equals(expectedTagContext2)).isTrue(); - } - - @Test - void verifyOverflowNotResolvedAfterLimitIncrease() { - Map maxValuesPerTagByMeasure = new HashMap<>(); - maxValuesPerTagByMeasure.put("measure", 1); - setupTagGuard(maxValuesPerTagByMeasure, null); - - TagContext expectedTagContext1 = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(TAG_VALUE_1)) - .build(); - - TagContext expectedOverflow = Tags.getTagger() - .emptyBuilder() - .putLocal(TagKey.create(TAG_KEY), TagValue.create(OVERFLOW)) - .build(); - - // first tag value should be accepted - TagContext tagContext1 = guard.getTagContext(context, metricAccessor1); - guard.blockTagValuesTask.run(); - // second tag value will exceed the limit - TagContext overflow1 = guard.getTagContext(context, metricAccessor2); - // increase tag limit to resolve overflow - maxValuesPerTagByMeasure.put("measure", 2); - setupTagGuard(maxValuesPerTagByMeasure, null); - guard.blockTagValuesTask.run(); - // second tag value should be accepted - TagContext overflow2 = guard.getTagContext(context, metricAccessor2); - - assertThat(tagContext1.equals(expectedTagContext1)).isTrue(); - assertThat(overflow1.equals(expectedOverflow)).isTrue(); - assertThat(overflow2.equals(expectedOverflow)).isTrue(); - } - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBufferTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBufferTest.java deleted file mode 100644 index 81dc50af44..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthIncidentBufferTest.java +++ /dev/null @@ -1,55 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring; - -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.Answers; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.junit.jupiter.MockitoExtension; -import org.springframework.context.ApplicationContext; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; -import rocks.inspectit.ocelot.core.SpringTestBase; -import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthIncidentAddedEvent; - -import static org.junit.jupiter.api.Assertions.assertEquals; -import static org.mockito.ArgumentMatchers.any; -import static org.mockito.Mockito.*; - -@ExtendWith(MockitoExtension.class) -public class AgentHealthIncidentBufferTest { - - @InjectMocks - private AgentHealthIncidentBuffer incidentBuffer; - @Mock - private ApplicationContext ctx; - @Mock(answer = Answers.RETURNS_DEEP_STUBS) - private InspectitEnvironment env; - - private AgentHealthIncident incident; - - @BeforeEach - void setUp() { - when(env.getCurrentConfig().getSelfMonitoring().getAgentHealth().getIncidentBufferSize()).thenReturn(2); - incident = new AgentHealthIncident("2001-01-01", AgentHealth.WARNING, this.getClass().getCanonicalName(), "Mock message", true); - } - @Test - void verifyBufferSize() { - incidentBuffer.put(incident); - incidentBuffer.put(incident); - incidentBuffer.put(incident); - - verify(ctx, times(3)).publishEvent(any(AgentHealthIncidentAddedEvent.class)); - } - - @Test - void verifyEventPublisher() { - incidentBuffer.put(incident); - incidentBuffer.put(incident); - incidentBuffer.put(incident); - - verify(ctx, times(3)).publishEvent(any(AgentHealthIncidentAddedEvent.class)); - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerDeadlockGh1597IntTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerDeadlockGh1597IntTest.java index 97e705b78a..6395640231 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerDeadlockGh1597IntTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerDeadlockGh1597IntTest.java @@ -1,7 +1,9 @@ package rocks.inspectit.ocelot.core.selfmonitoring; import org.awaitility.Awaitility; +import org.checkerframework.checker.units.qual.A; import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.Timeout; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; @@ -9,6 +11,8 @@ import rocks.inspectit.ocelot.core.SpringTestBase; import rocks.inspectit.ocelot.core.logging.logback.LogbackInitializer; +import java.util.Random; +import java.util.concurrent.Callable; import java.util.concurrent.TimeUnit; import java.util.concurrent.atomic.AtomicBoolean; @@ -24,7 +28,7 @@ public class AgentHealthManagerDeadlockGh1597IntTest extends SpringTestBase { private AgentHealthManager cut; @Test - void testLogging() { + void testLogging() throws Exception { // This installs InternalProcessingAppender which together with AgentHealthManager caused a deadlock LogbackInitializer.initDefaultLogging(); @@ -49,7 +53,7 @@ void testLogging() { Thread invalidationThread = new Thread(() -> { long start = System.currentTimeMillis(); while (System.currentTimeMillis() - start < millisToRun) { - cut.invalidateIncident(cut.getClass(), "Invalidation due to invalidator event"); + cut.onInvalidationEvent(cut.getClass()); } isInvalidationThreadDone.getAndSet(true); }); diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerIntTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerIntTest.java deleted file mode 100644 index bff61db4c8..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerIntTest.java +++ /dev/null @@ -1,107 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring; - -import org.junit.jupiter.api.*; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.test.annotation.DirtiesContext; -import org.springframework.test.context.TestPropertySource; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.SpringTestBase; -import rocks.inspectit.ocelot.core.config.propertysources.http.HttpConfigurationPoller; - -import static org.junit.jupiter.api.Assertions.assertEquals; - -/** - * Integration tests {@link AgentHealthManager} - */ -@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_CLASS) -@TestPropertySource(properties = "inspectit.self-monitoring.agent-health.validity-period:60s") -public class AgentHealthManagerIntTest extends SpringTestBase { - - @Autowired - private AgentHealthManager healthManager; - @Autowired - private HttpConfigurationPoller configurationPoller; - - /** - * Period how long a TimeOut AgentHealth is valid (+1s buffer) - */ - private final long validityPeriod = 61000; - - @Nested - class InvalidatableHealth { - - @Test - void verifyAgentHealthUpdating() { - AgentHealth currentManagerHealth = healthManager.getCurrentHealth(); - AgentHealth currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.OK); - - healthManager.notifyAgentHealth(AgentHealth.WARNING, this.getClass(), this.getClass().getName(), "Mock message"); - - currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.WARNING); - healthManager.notifyAgentHealth(AgentHealth.ERROR, this.getClass(), this.getClass().getName(), "Mock message"); - - currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.ERROR); - } - - @Test - void verifyAgentHealthInvalidation() throws InterruptedException { - AgentHealth currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - AgentHealth currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.OK); - - healthManager.notifyAgentHealth(AgentHealth.ERROR, this.getClass(), this.getClass().getName(), "Mock message"); - - currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.ERROR); - - healthManager.invalidateIncident(this.getClass(), "Mock invalidation"); - // simulate scheduler - Thread.sleep(validityPeriod); - healthManager.checkHealthAndSchedule(); - - currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.OK); - } - } - - @Nested - class TimeoutHealth { - - @Test - void verifyAgentHealthUpdating() throws InterruptedException { - AgentHealth currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - AgentHealth currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.OK); - - healthManager.notifyAgentHealth(AgentHealth.WARNING, null, this.getClass().getName(), "Mock message"); - - currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.WARNING); - - // simulate scheduler - Thread.sleep(validityPeriod); - healthManager.checkHealthAndSchedule(); - - currentHealth = configurationPoller.getCurrentAgentHealthState().getHealth(); - currentManagerHealth = healthManager.getCurrentHealth(); - assertEquals(currentHealth, currentManagerHealth); - assertEquals(currentHealth, AgentHealth.OK); - } - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerTest.java index b8436574c8..1ade277b13 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/AgentHealthManagerTest.java @@ -1,20 +1,30 @@ package rocks.inspectit.ocelot.core.selfmonitoring; +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.classic.spi.LoggingEvent; import org.junit.jupiter.api.*; import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.Answers; -import org.mockito.InjectMocks; -import org.mockito.Mock; +import org.mockito.ArgumentCaptor; import org.mockito.junit.jupiter.MockitoExtension; +import org.slf4j.LoggerFactory; import org.springframework.context.ApplicationContext; import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; +import rocks.inspectit.ocelot.config.model.InspectitConfig; +import rocks.inspectit.ocelot.config.model.selfmonitoring.AgentHealthSettings; +import rocks.inspectit.ocelot.config.model.selfmonitoring.SelfMonitoringSettings; import rocks.inspectit.ocelot.core.config.InspectitEnvironment; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; +import rocks.inspectit.ocelot.core.instrumentation.config.event.InstrumentationConfigurationChangedEvent; +import rocks.inspectit.ocelot.core.selfmonitoring.event.AgentHealthChangedEvent; import java.time.Duration; import java.util.concurrent.ScheduledExecutorService; -import static org.junit.jupiter.api.Assertions.assertEquals; +import java.util.concurrent.ScheduledThreadPoolExecutor; +import java.util.concurrent.TimeUnit; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.awaitility.Awaitility.await; import static org.mockito.Mockito.*; /** @@ -23,117 +33,126 @@ @ExtendWith(MockitoExtension.class) public class AgentHealthManagerTest { - @InjectMocks - private AgentHealthManager healthManager; - @Mock(answer = Answers.RETURNS_DEEP_STUBS) + private static final long VALIDITY_PERIOD_MILLIS = 500; + + private static InspectitConfig config; + + private ScheduledExecutorService executorService; + private InspectitEnvironment environment; - @Mock - private ScheduledExecutorService executor; - @Mock - private ApplicationContext ctx; - @Mock - private AgentHealthIncidentBuffer incidentBuffer; - @Nested - class InvalidatableHealth { + private ApplicationContext context; - @Test - void verifyAgentHealthChangedEvent() { - healthManager.notifyAgentHealth(AgentHealth.WARNING, this.getClass(), this.getClass().getName(), "Mock message"); + private AgentHealthManager healthManager; - verify(ctx).publishEvent(any(AgentHealthChangedEvent.class)); - } + @BeforeAll + static void createInspectitConfig() { + config = new InspectitConfig(); + AgentHealthSettings agentHealth = new AgentHealthSettings(); + agentHealth.setValidityPeriod(Duration.ofMillis(VALIDITY_PERIOD_MILLIS)); + SelfMonitoringSettings selfMonitoring = new SelfMonitoringSettings(); + selfMonitoring.setAgentHealth(agentHealth); + config.setSelfMonitoring(selfMonitoring); + } - @Test - void verifyAgentHealthIncidentAddedEvent() { - healthManager.notifyAgentHealth(AgentHealth.WARNING, this.getClass(), this.getClass().getName(), "Mock message"); + @BeforeEach + void setupStatusManager() { + executorService = new ScheduledThreadPoolExecutor(1); - verify(incidentBuffer).put(any(AgentHealthIncident.class)); - } + environment = mock(InspectitEnvironment.class); + when(environment.getCurrentConfig()).thenReturn(config); - @Test - void verifyNoAgentHealthIncidentAddedEvent() { - healthManager.notifyAgentHealth(AgentHealth.OK, this.getClass(), this.getClass().getName(), "Mock message"); + context = mock(ApplicationContext.class); - verifyNoInteractions(incidentBuffer); - } + healthManager = new AgentHealthManager(context, executorService, environment, mock(SelfMonitoringService.class)); + healthManager.startHealthCheckScheduler(); + } - @Test - void verifyInvalidateAgentHealthIncident() { - healthManager.notifyAgentHealth(AgentHealth.ERROR, this.getClass(), this.getClass().getName(), "Mock message"); - healthManager.invalidateIncident(this.getClass(), "Mock invalidation"); + @AfterEach + void shutdownExecutorService() { + executorService.shutdown(); + } - verify(ctx, times(2)).publishEvent(any(AgentHealthChangedEvent.class)); - verify(incidentBuffer, times(2)).put(any(AgentHealthIncident.class)); - } + private ILoggingEvent createLoggingEvent(Level level) { + return new LoggingEvent("com.dummy.Method", (Logger) LoggerFactory.getLogger(AgentHealthManagerTest.class), level, "Dummy Info", new Throwable(), new String[]{}); } - @Nested - class TimeoutHealth { - @BeforeEach - void setUpValidityPeriod() { - when(environment.getCurrentConfig().getSelfMonitoring().getAgentHealth().getValidityPeriod()) - .thenReturn(Duration.ofSeconds(5)); - } + private void verifyExactlyOneEventWasPublished(AgentHealth status) { + ArgumentCaptor statusCaptor = ArgumentCaptor.forClass(AgentHealthChangedEvent.class); + verify(context).publishEvent(statusCaptor.capture()); + assertThat(statusCaptor.getValue().getNewHealth()).isEqualTo(status); + verifyNoMoreInteractions(context); + } + + @Nested + class OnLogEvent { @Test - void verifyAgentHealthChangedEvent() { - healthManager.notifyAgentHealth(AgentHealth.WARNING, null, this.getClass().getName(), "Mock message"); + void logInstrumentationEvents() { + assertThat(healthManager.getCurrentHealth()).withFailMessage("Initial status shall be OK") + .isEqualTo(AgentHealth.OK); - verify(ctx).publishEvent(any(AgentHealthChangedEvent.class)); - } + healthManager.onLoggingEvent(createLoggingEvent(Level.INFO), InstrumentationConfigurationChangedEvent.class); + healthManager.onLoggingEvent(createLoggingEvent(Level.DEBUG), InstrumentationConfigurationChangedEvent.class); + assertThat(healthManager.getCurrentHealth()).withFailMessage("INFO and DEBUG messages shall not change the status") + .isEqualTo(AgentHealth.OK); - @Test - void verifyAgentHealthIncidentAddedEvent() { - healthManager.notifyAgentHealth(AgentHealth.WARNING, null, this.getClass().getName(), "Mock message"); + verifyNoInteractions(context); - verify(incidentBuffer).put(any(AgentHealthIncident.class)); - } + healthManager.onLoggingEvent(createLoggingEvent(Level.WARN), InstrumentationConfigurationChangedEvent.class); + assertThat(healthManager.getCurrentHealth()).withFailMessage("Status after WARN message shall be WARNING") + .isEqualTo(AgentHealth.WARNING); + verifyExactlyOneEventWasPublished(AgentHealth.WARNING); - @Test - void verifyNoAgentHealthIncidentAddedEvent() { - healthManager.notifyAgentHealth(AgentHealth.OK, null, this.getClass().getName(), "Mock message"); + clearInvocations(context); - verifyNoInteractions(incidentBuffer); - } + healthManager.onLoggingEvent(createLoggingEvent(Level.ERROR), InstrumentationConfigurationChangedEvent.class); + assertThat(healthManager.getCurrentHealth()).withFailMessage("Status after ERROR message shall be ERROR") + .isEqualTo(AgentHealth.ERROR); + verifyExactlyOneEventWasPublished(AgentHealth.ERROR); - @Test - void verifyAgentHealthTimeout() throws InterruptedException { - when(environment.getCurrentConfig().getSelfMonitoring().getAgentHealth().getValidityPeriod()) - .thenReturn(Duration.ofSeconds(5)); + clearInvocations(context); + + healthManager.onLoggingEvent(createLoggingEvent(Level.INFO), InstrumentationConfigurationChangedEvent.class); + assertThat(healthManager.getCurrentHealth()).withFailMessage("INFO messages shall not change the status") + .isEqualTo(AgentHealth.ERROR); + verifyNoMoreInteractions(context); - healthManager.notifyAgentHealth(AgentHealth.ERROR, null, this.getClass().getName(), "Mock message"); - // Wait 6s for time out (= 5s validityPeriod + 1s buffer) - Thread.sleep(6000); + clearInvocations(context); - assertEquals(healthManager.getCurrentHealth(), AgentHealth.OK); + healthManager.onInvalidationEvent(new InstrumentationConfigurationChangedEvent(this, null, null)); + assertThat(healthManager.getCurrentHealth()).withFailMessage("When new instrumentation was triggered, status shall be OK") + .isEqualTo(AgentHealth.OK); + verifyExactlyOneEventWasPublished(AgentHealth.OK); } @Test - void verifyCheckAgentHealth() throws InterruptedException { - when(environment.getCurrentConfig().getSelfMonitoring().getAgentHealth().getMinHealthCheckDelay()) - .thenReturn(Duration.ofSeconds(1)); + void logGeneralEvents() { + assertThat(healthManager.getCurrentHealth()).withFailMessage("Initial status shall be OK") + .isEqualTo(AgentHealth.OK); - healthManager.notifyAgentHealth(AgentHealth.ERROR, null, this.getClass().getName(), "Mock message"); - // Wait 6s for time out (= 5s validityPeriod + 1s buffer) - Thread.sleep(6000); + healthManager.onLoggingEvent(createLoggingEvent(Level.INFO), null); + healthManager.onLoggingEvent(createLoggingEvent(Level.DEBUG), null); + assertThat(healthManager.getCurrentHealth()).withFailMessage("INFO and DEBUG messages shall not change the status") + .isEqualTo(AgentHealth.OK); - healthManager.checkHealthAndSchedule(); + verifyNoInteractions(context); - verify(ctx, times(2)).publishEvent(any(AgentHealthChangedEvent.class)); - verify(incidentBuffer, times(2)).put(any(AgentHealthIncident.class)); - } + healthManager.onLoggingEvent(createLoggingEvent(Level.ERROR), null); + assertThat(healthManager.getCurrentHealth()).withFailMessage("Status after ERROR message shall be ERROR") + .isEqualTo(AgentHealth.ERROR); + verifyExactlyOneEventWasPublished(AgentHealth.ERROR); - @Test - void verifyCheckAgentHealthTooEarly() { - when(environment.getCurrentConfig().getSelfMonitoring().getAgentHealth().getMinHealthCheckDelay()) - .thenReturn(Duration.ofSeconds(1)); + clearInvocations(context); - healthManager.notifyAgentHealth(AgentHealth.ERROR, null, this.getClass().getName(), "Mock message"); - healthManager.checkHealthAndSchedule(); + await().atMost(VALIDITY_PERIOD_MILLIS * 2, TimeUnit.MILLISECONDS) + .untilAsserted(() -> assertThat(healthManager.getCurrentHealth()).withFailMessage("ERROR status should jump back to OK after timeout") + .isEqualTo(AgentHealth.OK)); - verify(ctx, times(1)).publishEvent(any(AgentHealthChangedEvent.class)); - verify(incidentBuffer, times(2)).put(any(AgentHealthIncident.class)); + await().atMost(VALIDITY_PERIOD_MILLIS * 2, TimeUnit.MILLISECONDS) + .untilAsserted(() -> verifyExactlyOneEventWasPublished(AgentHealth.OK)); } + } + } diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsIntTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsIntTest.java similarity index 96% rename from inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsIntTest.java rename to inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsIntTest.java index 1bb25069cb..676454eece 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsIntTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsIntTest.java @@ -1,4 +1,4 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; +package rocks.inspectit.ocelot.core.selfmonitoring; import ch.qos.logback.classic.Level; import ch.qos.logback.classic.spi.ILoggingEvent; @@ -12,7 +12,6 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; import rocks.inspectit.ocelot.core.logging.logback.InternalProcessingAppender; -import rocks.inspectit.ocelot.core.selfmonitoring.SelfMonitoringService; import java.lang.reflect.Field; import java.lang.reflect.InvocationTargetException; diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsRecorderTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsRecorderTest.java similarity index 93% rename from inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsRecorderTest.java rename to inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsRecorderTest.java index 07840e491d..cd09e988c1 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogMetricsRecorderTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogMetricsRecorderTest.java @@ -1,4 +1,4 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; +package rocks.inspectit.ocelot.core.selfmonitoring; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; @@ -10,7 +10,6 @@ import org.mockito.Mock; import org.mockito.junit.jupiter.MockitoExtension; import org.slf4j.LoggerFactory; -import rocks.inspectit.ocelot.core.selfmonitoring.SelfMonitoringService; import static org.mockito.ArgumentMatchers.*; import static org.mockito.Mockito.*; diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogPreloaderTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogPreloaderTest.java similarity index 98% rename from inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogPreloaderTest.java rename to inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogPreloaderTest.java index c9974b8c8c..14d6348ac0 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogPreloaderTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/LogPreloaderTest.java @@ -1,4 +1,4 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; +package rocks.inspectit.ocelot.core.selfmonitoring; import ch.qos.logback.classic.Level; import ch.qos.logback.classic.Logger; diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListenerTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListenerTest.java deleted file mode 100644 index 727d10ebff..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/LogWritingHealthEventListenerTest.java +++ /dev/null @@ -1,44 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import ch.qos.logback.classic.Logger; -import ch.qos.logback.classic.spi.ILoggingEvent; -import ch.qos.logback.core.read.ListAppender; -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.InjectMocks; -import org.mockito.junit.jupiter.MockitoExtension; -import org.slf4j.LoggerFactory; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; - -import static org.junit.jupiter.api.Assertions.assertTrue; -import static org.mockito.Mockito.verify; - -public class LogWritingHealthEventListenerTest { - - private final LogWritingHealthEventListener logWritingHealthEventListener = new LogWritingHealthEventListener(); - - private ListAppender listAppender; - - @BeforeEach - void setUp() { - listAppender = new ListAppender<>(); - listAppender.start(); - - Logger logger = (Logger) LoggerFactory.getLogger(Logger.ROOT_LOGGER_NAME); - logger.addAppender(listAppender); - } - - @Test - void verifyAgentHealthLogging() { - String eventMessage = "Mock message"; - AgentHealthChangedEvent event = new AgentHealthChangedEvent(this, AgentHealth.OK, AgentHealth.WARNING, eventMessage); - String expectedFullMessage = String.format("The agent status changed from %s to %s. Reason: %s", - AgentHealth.OK, AgentHealth.WARNING, eventMessage); - - logWritingHealthEventListener.onAgentHealthEvent(event); - - assertTrue(listAppender.list.stream().anyMatch(logEvent -> logEvent.getFormattedMessage().contains(expectedFullMessage))); - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListenerTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListenerTest.java deleted file mode 100644 index 1a7cafa011..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/MetricWritingHealthEventListenerTest.java +++ /dev/null @@ -1,48 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.junit.jupiter.MockitoExtension; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.selfmonitoring.SelfMonitoringService; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; - -import java.util.HashMap; - -import static org.mockito.Mockito.verify; - -@ExtendWith(MockitoExtension.class) -public class MetricWritingHealthEventListenerTest { - - private static final String INITIAL_METRIC_MESSAGE = "Initial health metric sent"; - - @InjectMocks - private MetricWritingHealthEventListener metricWritingHealthEventListener; - - @Mock - private SelfMonitoringService selfMonitoringService; - - @Test - void sendInitialHealthMetric() { - HashMap tags = new HashMap<>(); - tags.put("message", INITIAL_METRIC_MESSAGE); - - metricWritingHealthEventListener.sendInitialHealthMetric(); - - verify(selfMonitoringService).recordMeasurement("health", AgentHealth.OK.ordinal(), tags); - } - - @Test - void recordNewHealthMeasurement() { - AgentHealthChangedEvent event = new AgentHealthChangedEvent(this, AgentHealth.OK, AgentHealth.WARNING, "Mock Message"); - HashMap tags = new HashMap<>(); - tags.put("message", event.getMessage()); - tags.put("source", event.getSource().getClass().getName()); - - metricWritingHealthEventListener.onAgentHealthEvent(event); - - verify(selfMonitoringService).recordMeasurement("health", event.getNewHealth().ordinal(), tags); - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListenerTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListenerTest.java deleted file mode 100644 index da70c229d0..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/event/listener/PollerWritingHealthEventListenerTest.java +++ /dev/null @@ -1,60 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.event.listener; - -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.junit.jupiter.MockitoExtension; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthIncident; -import rocks.inspectit.ocelot.commons.models.health.AgentHealthState; -import rocks.inspectit.ocelot.core.config.propertysources.http.HttpConfigurationPoller; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthManager; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthChangedEvent; -import rocks.inspectit.ocelot.core.selfmonitoring.event.models.AgentHealthIncidentAddedEvent; - -import java.util.Collections; -import java.util.List; - -import static org.mockito.Mockito.verify; -import static org.mockito.Mockito.when; - -@ExtendWith(MockitoExtension.class) -public class PollerWritingHealthEventListenerTest { - - @InjectMocks - private PollerWritingHealthEventListener pollerWritingHealthEventListener; - @Mock - private HttpConfigurationPoller httpConfigurationPoller; - @Mock - private AgentHealthManager agentHealthManager; - - private List lastIncidents; - - @BeforeEach - void setUpIncidents() { - AgentHealthIncident incident = new AgentHealthIncident("2000-01-01", AgentHealth.WARNING, this.getClass().getCanonicalName(), "Mock message", true); - lastIncidents = Collections.singletonList(incident); - } - - @Test - void verifyAgentHealthUpdateOnChangedHealth() { - when(agentHealthManager.getIncidentHistory()).thenReturn(lastIncidents); - AgentHealthChangedEvent event = new AgentHealthChangedEvent(this, AgentHealth.OK, AgentHealth.WARNING, "Mock message"); - - pollerWritingHealthEventListener.onAgentHealthEvent(event); - AgentHealthState healthState = new AgentHealthState(AgentHealth.WARNING, this.toString(), "Mock message", lastIncidents); - - verify(httpConfigurationPoller).updateAgentHealthState(healthState); - } - @Test - void verifyAgentHealthUpdateOnAddedIncident() { - AgentHealthIncidentAddedEvent event = new AgentHealthIncidentAddedEvent(this, lastIncidents); - - pollerWritingHealthEventListener.onAgentHealthIncidentEvent(event); - AgentHealthState healthState = new AgentHealthState(AgentHealth.WARNING, this.getClass().getCanonicalName(), "Mock message", lastIncidents); - - verify(httpConfigurationPoller).updateAgentHealthState(healthState); - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitorTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitorTest.java deleted file mode 100644 index cccfd3dae0..0000000000 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/logs/LogHealthMonitorTest.java +++ /dev/null @@ -1,101 +0,0 @@ -package rocks.inspectit.ocelot.core.selfmonitoring.logs; - -import ch.qos.logback.classic.Level; -import ch.qos.logback.classic.Logger; -import ch.qos.logback.classic.spi.ILoggingEvent; -import ch.qos.logback.classic.spi.LoggingEvent; -import org.junit.jupiter.api.Nested; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.junit.jupiter.MockitoExtension; -import org.slf4j.LoggerFactory; -import rocks.inspectit.ocelot.commons.models.health.AgentHealth; -import rocks.inspectit.ocelot.core.config.PropertySourcesReloadEvent; -import rocks.inspectit.ocelot.core.selfmonitoring.AgentHealthManager; - -import static org.mockito.Mockito.verify; -import static org.mockito.Mockito.verifyNoMoreInteractions; - -@ExtendWith(MockitoExtension.class) -public class LogHealthMonitorTest { - - @InjectMocks - private LogHealthMonitor healthMonitor; - @Mock - private AgentHealthManager healthManager; - - private ILoggingEvent createLoggingEvent(Class loggedClass, Level logLevel) { - return new LoggingEvent("com.dummy.Method", (Logger) LoggerFactory.getLogger(loggedClass), logLevel, "Dummy Info", new Throwable(), new String[]{}); - } - - @Test - void ignoreLogsFromAgentHealthManagerClass() { - ILoggingEvent loggingEvent = createLoggingEvent(AgentHealthManager.class, Level.INFO); - - healthMonitor.onLoggingEvent(loggingEvent, null); - - verifyNoMoreInteractions(healthManager); - } - - @Test - void verifyNotifyAgentHealthOnInfo() { - Class loggerClass = LogHealthMonitor.class; - ILoggingEvent loggingEvent = createLoggingEvent(loggerClass, Level.INFO); - Class invalidatorMock = PropertySourcesReloadEvent.class; - AgentHealth eventHealth = AgentHealth.OK; - - healthMonitor.onLoggingEvent(loggingEvent, invalidatorMock); - - verify(healthManager).notifyAgentHealth(eventHealth, invalidatorMock, loggerClass.getCanonicalName(), loggingEvent.getFormattedMessage()); - } - - @Test - void verifyNotifyAgentHealthOnWarn() { - Class loggerClass = LogHealthMonitor.class; - ILoggingEvent loggingEvent = createLoggingEvent(loggerClass, Level.WARN); - Class invalidatorMock = PropertySourcesReloadEvent.class; - AgentHealth eventHealth = AgentHealth.WARNING; - - healthMonitor.onLoggingEvent(loggingEvent, invalidatorMock); - - verify(healthManager).notifyAgentHealth(eventHealth, invalidatorMock, loggerClass.getCanonicalName(), loggingEvent.getFormattedMessage()); - } - - @Test - void verifyNotifyAgentHealthOnError() { - Class loggerClass = LogHealthMonitor.class; - ILoggingEvent loggingEvent = createLoggingEvent(loggerClass, Level.ERROR); - Class invalidatorMock = PropertySourcesReloadEvent.class; - AgentHealth eventHealth = AgentHealth.ERROR; - - healthMonitor.onLoggingEvent(loggingEvent, invalidatorMock); - - verify(healthManager).notifyAgentHealth(eventHealth, invalidatorMock, loggerClass.getCanonicalName(), loggingEvent.getFormattedMessage()); - } - - @Test - void verifyNotifyAgentHealthOnTrace() { - Class loggerClass = LogHealthMonitor.class; - ILoggingEvent loggingEvent = createLoggingEvent(loggerClass, Level.TRACE); - Class invalidatorMock = PropertySourcesReloadEvent.class; - AgentHealth eventHealth = AgentHealth.OK; - - healthMonitor.onLoggingEvent(loggingEvent, invalidatorMock); - - verify(healthManager).notifyAgentHealth(eventHealth, invalidatorMock, loggerClass.getCanonicalName(), loggingEvent.getFormattedMessage()); - } - - @Test - void verifyNotifyAgentHealthOnDebug() { - Class loggerClass = LogHealthMonitor.class; - ILoggingEvent loggingEvent = createLoggingEvent(loggerClass, Level.DEBUG); - Class invalidatorMock = PropertySourcesReloadEvent.class; - AgentHealth eventHealth = AgentHealth.OK; - - healthMonitor.onLoggingEvent(loggingEvent, invalidatorMock); - - verify(healthManager).notifyAgentHealth(eventHealth, invalidatorMock, loggerClass.getCanonicalName(), loggingEvent.getFormattedMessage()); - } -} diff --git a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/service/DynamicallyActivatableServiceObserverTest.java b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/service/DynamicallyActivatableServiceObserverTest.java index e6dd0414ec..57c65a25cb 100644 --- a/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/service/DynamicallyActivatableServiceObserverTest.java +++ b/inspectit-ocelot-core/src/test/java/rocks/inspectit/ocelot/core/selfmonitoring/service/DynamicallyActivatableServiceObserverTest.java @@ -5,7 +5,7 @@ import rocks.inspectit.ocelot.core.command.AgentCommandService; import rocks.inspectit.ocelot.core.exporter.JaegerExporterService; import rocks.inspectit.ocelot.core.exporter.PrometheusExporterService; -import rocks.inspectit.ocelot.core.selfmonitoring.logs.LogPreloader; +import rocks.inspectit.ocelot.core.selfmonitoring.LogPreloader; import rocks.inspectit.ocelot.core.service.DynamicallyActivatableService; import java.util.ArrayList; diff --git a/inspectit-ocelot-documentation/docs/assets/agent-health-incidents.png b/inspectit-ocelot-documentation/docs/assets/agent-health-incidents.png deleted file mode 100644 index 36c8670a2278b6d28af71dcda8ffbb989adfd41f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 138677 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 diff --git a/inspectit-ocelot-documentation/docs/config-server/agent-mappings.md b/inspectit-ocelot-documentation/docs/config-server/agent-mappings.md index 58932a7555..2dfd3b79ee 100644 --- a/inspectit-ocelot-documentation/docs/config-server/agent-mappings.md +++ b/inspectit-ocelot-documentation/docs/config-server/agent-mappings.md @@ -9,7 +9,7 @@ Furthermore, you can specify which branch (`WORKSPACE` or `LIVE`) the mapping sh It's important to note that the first matching agent mapping will be used to determine which configuration is shipped to an agent. Additional agent mappings which may also match the attributes list sent by an agent will be ignored. -See section [HTTP-based Configuration](configuration/external-configuration-sources.md#http-based-configuration) for +See section [HTTP-based Configuration](configuration/external-configuration-sources.md#http-based-configuration) for information on how to specify which attributes will be sent by an agent. An agent mapping consists of the following properties: @@ -55,7 +55,7 @@ The `sourceBranch` property of an individual agent mapping determines, which bra ![Different Source Branches on Agent Mappings Page](assets/agent_mappings_source_branch.png) -You can define, which source branch should be used at start-up for the agent mappings +You can define, which source branch should be used at start-up for the agent mappings in the application properties of the configuration server: ```YAML @@ -93,3 +93,4 @@ The following agent mapping will deliver all configuration files located in the service: "customer-service" sourceBranch: "WORKSPACE" ``` + diff --git a/inspectit-ocelot-documentation/docs/metrics/tag-guard.md b/inspectit-ocelot-documentation/docs/metrics/tag-guard.md deleted file mode 100644 index b6fdd01f4c..0000000000 --- a/inspectit-ocelot-documentation/docs/metrics/tag-guard.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -id: tag-guard -title: Tag-Guard ---- - -Since version `2.6.0` it is possible to limit the amount of tag values of metrics. -This can be useful for controlling the amount of tag values, which will be written to your time series database -(e.g. InfluxDB or Prometheus). A high amount of unique tag values for a metric will result in a high cardinality, -which in turn might lead to performance or memory issues in your time series database. - -The recorded tag values for each measure of an agent will be stored inside a local JSON file. This file serves -as a tag-guard-database and helps to check, if tag values exceeded their limit. - -### Configuring Tag-Guard - -You can set the Tag-Guard configuration in `inspectit.metrics.tag-guard`. - -| Property | Default | Description | -|----------------------------------|--------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------| -| `.enabled` | `true` | Only when the tag-guard is enabled, the tag value limits will be checked. -| `.database-file` | `${inspectit.env.agent-dir}/${inspectit.service-name}/tag-guard-database.json` | The location of the JSON file with all recorded tag values. | -| `.schedule-delay` | `30s` | The delay for the scheduler, which will regularly compare the tag-guard-database with the configured tag value limits. | -| `.overflow-replacement` | `TAG_LIMIT_EXCEEDED` | After exceeding it's configured tag value limit, every tag will use this overflow replacement as value. | -| `.max-values-per-tag` | `1000` | The global tag value limit for every measure. | -| `.max-values-per-tag-by-measure` | `{}` | A map with measure names as key and their specific tag value limit as value. | - -There are three ways to define a tag value limit for measures. They are prioritized in the following order: - -1. Inside a metric definition for a particular measure -2. Globally for specific measures via `may-values-per-tag-by-measure` -3. Globally for all measures via `max-values-per-tag` - -This means that a tag value limit inside a metric definition will overwrite all other tag value limits -for the particular metric. A configured tag value limit in `max-values-per-tag-by-measure` will only overwrite the -globally set tag value limit in `max-values-per-tag` for the particular measure, but not a configured tag value limit -inside the metric definition. Let's look at an example: - -```yaml -inspectit: - metrics: - tag-guard: - max-values-per-tag: 1000 - max-values-per-tag-by-measure: - my_metric: 200 -``` - -In this configuration the global tag value limit is set to 1000, which means that every measure can only record 1000 unique -tag values for each tag. However, this does not apply to the measure `my_metric`, because the global tag value limit is -overwritten by `max-values-per-tag-by-measure` with 200. Thus, the measure `my_metric` can only record a maximum of 200 unique -tag values for each tag. - -Now, let's add another configuration: - -```yaml -inspectit: - metrics: - definitions: - 'my_metric': - tag-guard: 100 -``` - -This metric definition will overwrite the tag value limit specified in `max-values-per-tag-by-measure` for the measure `my_metric`, -resulting in a tag value limit of 100. Every other measure still uses the globally configured tag value -limit of 1000. - - -### Agent Health Monitoring - -If the tag value for a specific agent is exceeded, the Tag-Guard scheduler will detect an overflow and change -the agent health to `ERROR`. -Additionally, an agent health incident will be created, mentioning which tag-key has exceeded its tag value limit. -In the [Agent Status Table View](../config-server/status-table-view.md) of the Configuration-Server you can click on the -health state icon of a particular agent to view its last agent health incidents. You can set the amount of buffered incidents -with `inspectit.self-monitoring.agent-health.incident-buffer-size`. A list of incidents could look like this: - -![List of agent health incidents](assets/agent-health-incidents.png) - - -### How To Fix A Tag Value Overflow - -If a tag value limit was exceeded, there are two options to resolve the agent health `ERROR`. - -The **first option** would be to increase the tag value limit. Probably the limit has been estimated too low and thus has -to be increased. After increasing the tag value limit, the tag-guard-database scheduler will resolve the `ERROR`. - -The **second option** would be to adjust your configuration or application so the tag value limit should not be exceeded anymore. -After the adjustment, you will have to "reset" the recorded tag values in the tag-guard-database to resolve the `ERROR`. -One way to reset the tag-guard-database is to delete the local JSON file. However, this will delete all recorded tag values -and might not be the preferred solution.
    -A more preferable solution would be to only reset the tag values for a specific tag of a measure, -which has exceeded its tag value limit. -To do this, you could use the _**jq command-line JSON processor**_, which has to be installed on your system manually. -For example, you could use the following command, if you would like to delete all recorded tag values for the tag _my_tag_ inside the measure _my_metric_: - -- Unix: `jq '.my_metric.my_tag = []' tag-guard-database.json > temp.json && mv temp.json tag-guard-database.json` -- Windows: `jq ".my_metric.my_tag = []" tag-guard-database.json > temp.json && move temp.json tag-guard-database.json` - -In future versions of inspectIT there might be an option to reset specific tag values directly in the Configuration-Server UI. diff --git a/inspectit-ocelot-documentation/docs/tracing/tracing.md b/inspectit-ocelot-documentation/docs/tracing/tracing.md index 4560f3f025..01b5770e68 100644 --- a/inspectit-ocelot-documentation/docs/tracing/tracing.md +++ b/inspectit-ocelot-documentation/docs/tracing/tracing.md @@ -75,7 +75,7 @@ inspectit: propagation-format: B3 # the format for propagating correlation headers ``` -Currently, the following formats are supported for sending correlation information: +Currently the following formats are supported for sending correlation information: | Property | Format | Description |---|---|---| @@ -87,61 +87,6 @@ Currently, the following formats are supported for sending correlation informati It is important to note that this configuration refers to the format of the correlation information used to **send this data**. When processing correlation information that the agent receives, it automatically uses the correct format. ::: -### Adding Metric Tags - -It is possible to include all metrics tags of the current rule scope as tracing attributes. -This way it isn't necessary to define key-value pairs twice for metrics as well as tracing. -However, it is only possible to use metric tags as tracing attributes, but not vice versa! - -You can disable this feature in the tracing configuration: - -```YAML -inspectit: - tracing: - add-metric-tags: true -``` - -In this example, both tags of the metric `my_counter` will be used as attributes for the tracing within this rule. - -```YAML -rules: - 'r_example': - include: - 'r_myRule': true - entry: - 'my_data': - action: 'a_getData' - metrics: - my_counter: - value: 1 - data-tags: - 'example': 'my_data' - constant-tags: - 'scope': 'EXAMPLE' -``` - -Each tag key can only be used once within one trace. Thus, if a tag key has been assigned multiple values within one rule, -the acquired tag value will be determined hierarchically. Tag keys defined in `metrics.data-tags` will overwrite tag keys -defined in `metrics.constant-tags`. Tag keys defined in `tracing.attributes` will always overwrite tag keys defined in `metrics`. -In the example below, the tracing attributes will use 'trace' as value for 'myTag' and 'yourData' as value for 'yourTag'. - - -```YAML -rules: - 'r_example': - tracing: - attributes: - 'myTag': 'trace' - metrics: - my_counter: - data-tags: - 'myTag': 'myData' - 'yourTag': 'yourData' - constant-tags: - 'yourTag': 'CONSTANT' -``` - - ### Using 64-Bit Trace IDs Since version 2.0.0, the inspectIT Ocelot Agent is able to generate trace IDs with a size of 64 bits instead of the 128 bit trace IDs used by default by the agent. @@ -155,4 +100,4 @@ inspectit: :::important Please note that some propagation formats do not support 64-bit Ids, such as the W3C "Trace Context". In this case the 64-bit trace IDs are padded with leading zeros. -::: +::: \ No newline at end of file diff --git a/inspectit-ocelot-documentation/website/sidebars.json b/inspectit-ocelot-documentation/website/sidebars.json index 1f32b88ff1..53bfd828d1 100644 --- a/inspectit-ocelot-documentation/website/sidebars.json +++ b/inspectit-ocelot-documentation/website/sidebars.json @@ -20,8 +20,7 @@ "metrics/metric-exporters", "metrics/common-tags", "metrics/custom-metrics", - "metrics/self-monitoring", - "metrics/tag-guard" + "metrics/self-monitoring" ], "Tracing": [ "tracing/tracing",