Popularity
1.6
Growing
Activity
0.3
Declining
1
2
0

Programming language: Crystal
License: MIT License
Tags: Logging And Monitoring    

crystal-logreader alternatives and similar shards

Based on the "Logging and monitoring" category.
Alternatively, view crystal-logreader alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of crystal-logreader or a related project?

Add another 'Logging and monitoring' Shard

README

LogReader

Reading lines in the text file which is growing and may be rotated, such as unix system log file.

  • When the current file reaches EOF, this will wait new line added to the file. (like tail -f command)
  • Even when the current file is rotated, this will trace new file and continue reading lines.

Installation

Add this to your application's shard.yml:

dependencies:
  logreader:
    github: arcage/crystal-logreader

Usage

require "logreader"

# create LogReader object
log = LogReader.new("/var/log/maillog")

# reads single line from the file
# waits new line, when the file reaches EOF
puts log.read_line

# iterates each line in the file
log.each do |line|
  puts line
end

LogReader has only two public instance method #read_line and #each

#each will not finish in normal operation. if you want to stop it, you have to do it forcibly by using Ctrl+C, kill command etc.

Internal behaviour

When reading no data for reasons such as EOF, LogReader try to read more data every second.

For every consecutive 5 results that no data read, LogReader checks whether or not the inode number associated with the file name was changed.

If it had been changed, LogReader close current file and re-open the file.

Contributors

  • arcage ʕ·ᴥ·ʔAKJ - creator, maintainer