Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Maven Central

This is a JBossAS7/Wildfly subsystem module to provide injection/JNDI bindings of GelfSender and Datenpumpe instances.

But wait: What is Datenpumpe?

TL;DR; Datenpumpe allows you to submit your own data structures to be processed by logstash, ElasticSearch and Kibana (the ELK stack)

And the longer version: Datenpumpe is a concept evolved from submitting log entries using GELF (Graylog Extended Log Format, see also logstash-gelf was intended to allows simple submission of log events to logstash. With starting to use the ELK stack (see you will explore the possibilities of centralized event and data management. This causes the need to be able to submit any data to your logstash for later resarch and statistics gathering. Datenpumpe takes proven working components and allows you to submit your own data strucures. This is useful for event processing of bussiness and technical events.


public class MyServlet extends HttpServlet {

    @Resource(mappedName = "jndi:/jboss/datenpumpe")
    public Datenpumpe datenpumpe;
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)  {
        Map<String, Object> message = new HashMap<>;
        message.put("uri", req.getRequestUri());
        message.put("resource", "MyServlet");
        message.put("event", "access");

Or more sophisticated (using reflection to retrieve the fields from your model):

public class MyEjb {

    @Resource(mappedName = "jndi:/jboss/datenpumpe")
    public Datenpumpe datenpumpe;
    public void shoppingCartOrdered(ShoppingCart cart) {

public class ShoppingCart{

    private String cartId;
    private double amount;
    private String customerId;
    public String getCartId(){
        return cartId;
    public double getAmount(){
        return amount;
    public String getCustomerId(){
        return customerId;

This results in a Gelf message like:

{ "timestamp": "1406797244.645",
  "facility": "logstash-gelf", 
  "_cartId": "the cart id", 
  "_amount": 9.27,
  "_customerId": "the customer id" }

How to get

JBoss AS7 and Wildfly modules are not binary compatible, therefore you need to download the right library.

JBoss AS7 Module Download:


Wildfly (AS8) Module Download:


How to install

Download the zipped module and drop the contents of the zip-file (without the top-level directory logstash-gelf-subsystem-(version)) into your JBoss' module directory (either below modules/system/layers/base, a new layer or below modules/ directly). The module zip contains also the dependency to logstash-gelf, so you don't need to download it separately.

Activating the subsystem

Add following lines to your JBoss config

In the extensions section (below server/extensions):

    <extension module="biz.paluch.logging.logstash-gelf-subsystem"/>

And anywhere in the profile secion (below server/profile):

    <subsystem xmlns="urn:biz.paluch.logging:logstash-gelf-subsystem:1.0">

Afterwards you can add Datenpumpe or GelfSender instances.

CLI Configuration

Adding a new Datenpumpe:

/subsystem=logstash-gelf-subsystem/datenpumpe="jndi:/jboss/datenpumpe"/:add(jndi-name="jndi:/jboss/datenpumpe", host="udp:logstash-host", port=12201)

Adding a new GelfSender:

/subsystem=logstash-gelf-subsystem/sender="jndi:/jboss/sender"/:add(jndi-name="jndi:/jboss/sender", host="udp:logstash-host", port=12201)

XML Configuration

Adding a new Datenpumpe:

<subsystem xmlns="urn:biz.paluch.logging:logstash-gelf-subsystem:1.0">
    <datenpumpe host="udp:logstash-host" port="12201" jndi-name="jndi:/jboss/datenpumpe" />

Adding a new GelfSender:

<subsystem xmlns="urn:biz.paluch.logging:logstash-gelf-subsystem:1.0">
    <sender host="udp:logstash-host" port="12201" jndi-name="jndi:/jboss/sender" />


Notes on redis Connection



Github is for social coding: if you want to write code, I encourage contributions through pull requests from forks of this repository. Create Github tickets for bugs and new features and comment on the ones that you are interested in.


No description, website, or topics provided.




No packages published