Log Output Adapter Sample

Introduction

This sample demonstrates the StreamBase Log adapter, an output adapter that sends its input tuples to the StreamBase logging system.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top menu, click FileLoad StreamBase Sample.

  • Select this sample from the Embedded Output Adapters list.

  • Click OK.

StreamBase Studio creates a single project containing the sample files.

Sample Location

By default, the sample files are installed in the following default locations:

On Windows

C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\adapter\embedded\log\

On UNIX

/opt/streambase/sample/adapter/embedded/log/

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace. StreamBase Systems recommends that you use the workspace copy of the sample, especially on UNIX, where you may not have write access to /opt/streambase. In the default installation, the path to this sample in your Studio workspace is:

UNIX:       
  ~/streambase-studio-n.m-workspace/sample_adapter_embedded_log
Windows XP:
  C:\Documents and Settings\username\My Documents\
      StreamBase Studio n.m Workspace\sample_adapter_embedded_log
Windows Vista:
  C:\Users\username\Documents\StreamBase Studio n.m Workspace\
      sample_adapter_embedded_log

Running this Sample in StreamBase Studio

  1. In the Package Explorer, double-click to open the log.sbapp application. Make sure the application is the currently active tab in the EventFlow Editor.

  2. Click the Run button. This opens the SB Test/Debug perspective and starts the application.

  3. Use the Manual Input view to send integer values to the input stream.

  4. As usual, the Application Input view shows the tuples you send, while the Application Output view shows the tuples as received on the output port. But the Console View also shows one log message for each tuple. The log message shows the logging level (INFO, WARN, DEBUG, TRACE) and log message prefix that you specified in the Log adapter's Properties view.

  5. When done, press F9 or click the Stop Running Application button.

Running This Sample in Terminal Windows

This section describes how to run the sample in UNIX terminal windows or Windows command prompt windows. On Windows, be sure to use the StreamBase Command Prompt from the Start menu as described in the Test/Debug Guide, not the default command prompt.

  1. Open two terminal windows on UNIX, or two StreamBase Command Prompts on Windows. In each window, navigate to your workspace copy of the sample, as described above.

  2. In window 1, type:

    sbd log.sbapp

    The window shows a log message notice ... listening on port 10000.

  3. In window 2: type:

    sbc enq InputStream1

  4. In window 2, type a series of integers and press Return after each number.

    Notice that there is a log message in window 1 for each input tuple you send. The log message shows the logging level (INFO, WARN, DEBUG, TRACE) and log message prefix that you specified in the Log adapter's Properties view.

  5. In window 2, type: Ctrl-C to exit the sbc session.

  6. In window 2, type the following command to terminate the server:

    sbadmin shutdown

Back to Top ^