Joule
  • Welcome to Joule's Docs
  • Why Joule?
    • Joule capabilities
  • What is Joule?
    • Key features
    • The tech stack
  • Use case enablement
    • Use case building framework
  • Concepts
    • Core concepts
    • Low code development
    • Unified execution engine
    • Batch and stream processing
    • Continuous metrics
    • Key Joule data types
      • StreamEvent object
      • Contextual data
      • GeoNode
  • Tutorials
    • Getting started
    • Build your first use case
    • Stream sliding window quote analytics
    • Advanced tutorials
      • Custom missing value processor
      • Stateless Bollinger band analytics
      • IoT device control
  • FAQ
  • Glossary
  • Components
    • Pipelines
      • Use case anatomy
      • Data priming
        • Types of import
      • Processing unit
      • Group by
      • Emit computed events
      • Telemetry auditing
    • Processors
      • Common attributes
      • Filters
        • By type
        • By expression
        • Send on delta
        • Remove attributes
        • Drop all events
      • Enrichment
        • Key concepts
          • Anatomy of enrichment DSL
          • Banking example
        • Metrics
        • Dynamic contextual data
          • Caching architecture
        • Static contextual data
      • Transformation
        • Field Tokeniser
        • Obfuscation
          • Encryption
          • Masking
          • Bucketing
          • Redaction
      • Triggers
        • Change Data Capture
        • Business rules
      • Stream join
        • Inner stream joins
        • Outer stream joins
        • Join attributes & policy
      • Event tap
        • Anatomy of a Tap
        • SQL Queries
    • Analytics
      • Analytic tools
        • User defined analytics
          • Streaming analytics example
          • User defined analytics
          • User defined scripts
          • User defined functions
            • Average function library
        • Window analytics
          • Tumbling window
          • Sliding window
          • Aggregate functions
        • Analytic functions
          • Stateful
            • Exponential moving average
            • Rolling Sum
          • Stateless
            • Normalisation
              • Absolute max
              • Min max
              • Standardisation
              • Mean
              • Log
              • Z-Score
            • Scaling
              • Unit scale
              • Robust Scale
            • Statistics
              • Statistic summaries
              • Weighted moving average
              • Simple moving average
              • Count
            • General
              • Euclidean
        • Advanced analytics
          • Geospatial
            • Entity geo tracker
            • Geofence occupancy trigger
            • Geo search
            • IP address resolver
            • Reverse geocoding
            • Spatial Index
          • HyperLogLog
          • Distinct counter
      • ML inferencing
        • Feature engineering
          • Scripting
          • Scaling
          • Transform
        • Online predictive analytics
        • Model audit
        • Model management
      • Metrics engine
        • Create metrics
        • Apply metrics
        • Manage metrics
        • Priming metrics
    • Contextual data
      • Architecture
      • Configuration
      • MinIO S3
      • Apache Geode
    • Connectors
      • Sources
        • Kafka
          • Ingestion
        • RabbitMQ
          • Further RabbitMQ configurations
        • MQTT
          • Topic wildcards
          • Session management
          • Last Will and Testament
        • Rest endpoints
        • MinIO S3
        • File watcher
      • Sinks
        • Kafka
        • RabbitMQ
          • Further configurations
        • MQTT
          • Persistent messaging
          • Last Will and Testament
        • SQL databases
        • InfluxDB
        • MongoDB
        • Geode
        • WebSocket endpoint
        • MinIO S3
        • File transport
        • Slack
        • Email
      • Serialisers
        • Serialisation
          • Custom transform example
          • Formatters
        • Deserialisers
          • Custom parsing example
    • Observability
      • Enabling JMX for Joule
      • Meters
      • Metrics API
  • DEVELOPER GUIDES
    • Setting up developer environment
      • Environment setup
      • Build and deploy
      • Install Joule
        • Install Docker demo environment
        • Install with Docker
        • Install from source
        • Install Joule examples
    • Joulectl CLI
    • API Endpoints
      • Mangement API
        • Use case
        • Pipelines
        • Data connectors
        • Contextual data
      • Data access API
        • Query
        • Upload
        • WebSocket
      • SQL support
    • Builder SDK
      • Connector API
        • Sources
          • StreamEventParser API
        • Sinks
          • CustomTransformer API
      • Processor API
      • Analytics API
        • Create custom metrics
        • Define analytics
        • Windows API
        • SQL queries
      • Transformation API
        • Obfuscation API
        • FieldTokenizer API
      • File processing
      • Data types
        • StreamEvent
        • ReferenceDataObject
        • GeoNode
    • System configuration
      • System properties
  • Deployment strategies
    • Deployment Overview
    • Single Node
    • Cluster
    • GuardianDB
    • Packaging
      • Containers
      • Bare metal
  • Product updates
    • Public Roadmap
    • Release Notes
      • v1.2.0 Join Streams with stateful analytics
      • v1.1.0 Streaming analytics enhancements
      • v1.0.4 Predictive stream processing
      • v1.0.3 Contextual SQL based metrics
    • Change history
Powered by GitBook
On this page
  • Overview
  • Use cases
  • Architecture
  • Example & DSL attributes
  • Explanation
  • Attributes schema

Was this helpful?

  1. Components
  2. Contextual data

Apache Geode

High-performance caching platform for static and slow-moving contextual data

PreviousMinIO S3NextConnectors

Last updated 5 months ago

Was this helpful?

Fractalworks has extensive experience developing real-time event based solutions and products that applies this technology.

Please for for details on how we can help you.

Overview

Apache Geode integrates with Joule as a high-performance, in-memory key-value store. As an essential part of the the platform, it provides low-latency access to contextual data for advanced stream processing.

Known for its reliability and scalability, Geode has supported large-scale enterprise solutions for over 20 years.

In Joule, Geode enables immediate updates from a distributed cluster, allowing processors to use the latest data in real-time without manual refreshes. To learn more about the features of Apache Geode, we invite you to read this for a really good overview.

Driver details:

Storage regions can be primed on startup using either a custom query or a getAll function otherwise data is fetched on cache misses.

Furthermore, for cached data elements, data updates are immediately propagated from the connected distributed cluster to the Joule process thereby enabling up-to-date contextual data.

Use cases

Geode is ideal for handling various types of static or slow-moving reference data, critical in scenarios requiring low-latency access and high concurrency. Common examples include:

Typical use cases include:

  1. Geographic and regional data Postal codes, country codes (e.g., ISO-366).

  2. Device and market data Mobile manufacture models, market exchange codes.

  3. Currency data Currency codes for international transactions.

  4. Machine learning models Pre-trained models for real-time predictions.

  5. Static variables and codes Charge codes, car VINs, pre-computed data for analysis.

  6. Pattern matching Regex patterns for validating inputs, such as phone numbers.

Architecture

Joule leverages a connected Geode client cache that initially links through the Geode locator, and then after connects directly to cluster members. This approach supports on-demand loading of dynamic contextual data, enhancing data retrieval speeds and ensuring scalability for high-throughput environments.

Example & DSL attributes

The following example is a configuration for integrating Apache Geode as a data source within Joule:

contextual data:
 ...
    - geode stores:
          name: us markets
          connection:
              locator address: 192.168.86.39
              locator port: 41111
          stores:
            nasdaqIndex:
              region: nasdaq-companies
              keyClass : java.lang.String
              gii: true
            holidays:
              region: us-holidays
              keyClass : java.lang.Integer

Explanation

This configuration specifies Geode as a data source, linking two key regions: nasdaq-companies and us-holidays.

The gii (get-initial-image) option for nasdaqIndex ensures data is primed on startup, minimising cache misses. By connecting via the provided locator address and port, Joule gains access to the Geode distributed cluster, ensuring the most up-to-date data in the processing pipeline.

Attributes schema

Attribute
Description
Data Type
Required

name

Logical name of reference data set for given target connection

String

locator address

Locator process IP address

String Default: localhost

locator port

The port the cluster locator listens for cluster and client connections

Integer Default: 41111

stores

Map of logical names to region configurations. See Region attributes

List of logical storage name to Geode storage region

It’s recommended to review to understand the distributed data cluster architecture. This will inform you of the benefits of the solution.

contact us
article
org.apache.geode:geode-core:1.15.1
Apache Geode documentation
Joule integration architecture for Apache Geode