https://github.com/oneteme/inspect-core

inspect java/spring collector
https://github.com/oneteme/inspect-core

agent collector java tracking

Last synced: 3 months ago
JSON representation

inspect java/spring collector

• Host: GitHub
• URL: https://github.com/oneteme/inspect-core
• Owner: oneteme
• License: apache-2.0
• Created: 2023-03-31T15:01:44.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2026-01-19T09:25:25.000Z (6 months ago)
• Last Synced: 2026-01-19T16:53:15.822Z (6 months ago)
• Topics: agent, collector, java, tracking
• Language: Java
• Homepage:
• Size: 1.23 MB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# inspect-core

[![Maven Central Version](https://img.shields.io/maven-central/v/io.github.oneteme/inspect-core?style=social)](https://central.sonatype.com/artifact/io.github.oneteme/inspect-core)  

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](./LICENSE)

Short description

-----------------

inspect-core is a lightweight Java library to capture structured runtime telemetry (sessions, requests, resource metrics and thread correlations) from monolithic or distributed applications. It focuses on producing correlated traces that can be dispatched to an inspect server or written locally for offline analysis.

Why use inspect-core?

- End-to-end correlated tracing across threads and asynchronous work.

- Capture HTTP, JDBC, LDAP, FTP/SFTP, SMTP and local operations.

- Configurable local dump or remote dispatch to an inspect-server.

- Minimal intrusion: pluggable collectors and Spring-friendly integrations.

Quick Start

-----------

Maven

```xml

  io.github.oneteme

  inspect-core

  REPLACE_WITH_VERSION

```

Configuration (example application.yml)

```yaml

inspect:

  collector:

    enabled: true

    debug-mode: false

    scheduling:

      interval: 5s

    monitoring:

      http-route:

        excludes:

          method: OPTIONS

          path: /favicon.ico, /actuator/info

      resources:

        enabled: true

      exception:

        max-stack-trace-rows: -1

        max-cause-depth: -1

    tracing:

      queue-capacity: 1000

      delay-if-pending: 0

      dump:

        enabled: false

      remote:

        mode: REST

        host: https://inspect-server.example.com

        retention-max-age: 30d

```

Key Concepts

------------

- Session: Logical processing unit (app startup, batch job, incoming request) that groups related events.

- Request: Interaction with external/local resources with metadata (type, duration, status, error).

- Thread correlation: Propagate session context across threads to maintain continuity.

- Resource monitoring: Periodic basic system metrics (memory, disk) aligned with trace timelines.

Integration Notes

-----------------

- Spring Boot: add dependency and enable collector via configuration.

- Web clients: supports both blocking (ClientHttpRequestInterceptor) and reactive (ExchangeFilterFunction) capture.

- Sensitive data: redact Authorization headers, PII and large payloads before dispatch.

Build & Test

------------

Maven:

```bash

mvn clean test

mvn -DskipTests package

```

Contribute

----------

Fork → feature branch → PR with tests and documentation. See CONTRIBUTING.md for details.

License & Contact

-----------------

Apache License 2.0 — see LICENSE file. Report issues on GitHub.