kilianc/rtail

Support for third party log sources

Open

#97 opened on Oct 10, 2015

View on GitHub
 (1 comment) (0 reactions) (0 assignees)CSS (1,624 stars) (111 forks)batch import
enhancementhelp wanted

Description

Providing a means for third parties to push logs to rtail-server would be useful. I would expect some configurable form of delineation to specify stream source, etc and a general form of the message to be sent.
Example from the log.io page: https://github.com/NarrativeScience/Log.io#server-tcp-interface

+log|my_stream|my_node|info|this is log message\r\n

Particularly useful when logs originate from systems that do not have unix pipes. (Windows)

Contributor guide

Tech stack
nodejs
Domain
backendcliapi
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
TCP/IP networkingNode.jsrtail codebase
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
The issue requests a TCP interface for third party log sources, similar to Log.io's TCP protocol. Research the Log.io server TCP interface linked in the issue (https://github.com/NarrativeScience/Log.io#server tcp interface). Explore the rtail server codebase (likely in the rtail repository under the server directory) to understand its existing architecture and message handling. Consider implementing a TCP server that accepts messages in a format like '+log|stream|node|level|message'. Ensure the server can parse this format and forward logs to connected WebSocket clients. The implementation should be configurable and well documented.