gelf-pro
- Node.js 的 Graylog2 客户端库.
以 GELF(Graylog 扩展日志格式)格式将日志发送到 Graylog2 服务器。
特征:
"dependencies": {
"gelf-pro": "~1.3" // see the "releases" section
}
npm install gelf-pro
(支持所有node.js 版本 [0.x 到 2x.x] :)
库依赖: lodash#~4.17
var log = require ( 'gelf-pro' ) ;
警告
为了确保行为一致,现有适配器都不会重复使用套接字连接。重复使用套接字连接可能会导致资源泄漏、状态管理复杂性、并发问题、安全风险,并且可能并不总是能提供显着的性能优势。根据需要建立新连接通常比重复使用现有连接更简单、更安全,从而确保更好的资源利用率并减少网络通信中潜在的复杂性。
有多种 (1, 2) 变体可供您借用并创建新的适配器。请参阅相关部分。
GELF UDP
GELF TCP
(带有Null frame delimiter
)GELF TCP
(带有Null frame delimiter
和Enable TLS
) 笔记
在或多或少稳定的网络中(这是最有可能的),我建议使用udp
适配器。我还会推荐它用于平均负载到高负载的项目。对于敏感信息,建议使用tcp-tls
适配器。
// simple
log . setConfig ( { adapterOptions : { host : 'my.glog-server.net' } } ) ;
// advanced
log . setConfig ( {
fields : { facility : "example" , owner : "Tom (a cat)" } , // optional; default fields for all messages
filter : [ ] , // optional; filters to discard a message
transform : [ ] , // optional; transformers for a message
broadcast : [ ] , // optional; listeners of a message
levels : { } , // optional; default: see the levels section below
aliases : { } , // optional; default: see the aliases section below
adapterName : 'udp' , // optional; currently supported "udp", "tcp" and "tcp-tls"; default: udp
adapterOptions : { // this object is passed to the adapter.connect() method
// common
host : '127.0.0.1' , // optional; default: 127.0.0.1
port : 12201 , // optional; default: 12201
// ... and so on
// tcp adapter example
family : 4 , // tcp only; optional; version of IP stack; default: 4
timeout : 1000 , // tcp only; optional; default: 10000 (10 sec)
// udp adapter example
protocol : 'udp4' , // udp only; optional; udp adapter: udp4, udp6; default: udp4
// tcp-tls adapter example
key : fs . readFileSync ( 'client-key.pem' ) , // tcp-tls only; optional; only if using the client certificate authentication
cert : fs . readFileSync ( 'client-cert.pem' ) , // tcp-tls only; optional; only if using the client certificate authentication
ca : [ fs . readFileSync ( 'server-cert.pem' ) ] // tcp-tls only; optional; only for the self-signed certificate
}
} ) ;
log.setConfig
合并数据。因此,您可以多次调用它。
var extra = { tom : 'cat' , jerry : 'mouse' , others : { spike : 1 , tyke : 1 } } ;
log . info ( "Hello world" , extra , function ( err , bytesSent ) { } ) ;
log . info ( "Hello world" , function ( err , bytesSent ) { } ) ;
log . info ( "Hello world" , extra ) ;
log . info ( "Hello world" ) ;
log . error ( 'Oooops.' , new Error ( 'An error message' ) ) ;
// ^-- extra becomes: {short_message: 'Oooops.', _error_message: 'An error message', _error_stack: Error's stack}
log . error ( new Error ( 'An error message' ) ) ;
// ^-- extra becomes: {short_message: 'An error message', full_message: Error's stack}
log . message ( new Error ( 'An error message' ) , 3 ) ; // same as previous
如果extra
是普通对象,库会将其转换为可读格式。其他值转换为字符串。可接受的密钥格式为: ^[w-]$
log . info (
'a new msg goes here' ,
{ me : { fname : 'k' , lname : 'k' , bdate : new Date ( 2000 , 01 , 01 ) } }
) ;
// ^-- extra becomes: {_me_fname: 'k', _me_lname: 'k', _me_bdate: 'Tue Feb 01 2000 00:00:00 GMT+0100 (CET)'}
有时我们不得不丢弃一条不适合当前环境的消息。 NOT
修改数据。
log . setConfig ( {
filter : [
function ( message ) { // rejects a "debug" message
return ( message . level < 7 ) ;
}
]
} ) ;
transforming
发生在filtering
之后。可以修改数据。
log . setConfig ( {
transform : [
function ( message ) { // unwind an error
if ( _ . isError ( message . error ) ) {
message . error = { message : message . error . message , stack : message . error . stack } ;
}
return message ;
}
]
} ) ;
broadcasting
发生在transforming
之后。 NOT
修改数据。
log . setConfig ( {
broadcast : [
function ( message ) { // broadcasting to console
console [ message . level > 3 ? 'log' : 'error' ] ( message . short_message , message ) ;
}
]
} ) ;
默认:
{emergency: 0, alert: 1, critical: 2, error: 3, warning: 4, notice: 5, info: 6, debug: 7}
示例: log.emergency(...)
、 log.critical(...)
等。
自定义示例: {alert: 0, notice: 1, ...}
您可以通过在初始化后立即设置adapter
来强制使用自定义适配器。签名可以在这里找到。
var log = require ( 'gelf-pro' ) ;
var myFancyAdapter = require ( '...' ) ;
log . adapter = myFancyAdapter ;
// (!) adapterName and adapterOptions will be ignored
默认值: {log: 'debug', warn: 'warning'}
示例: log.log(...) -> log.debug(...)
、 log.warn(...) -> log.warning(...)
等。
自定义示例: {red: 'alert', yellow: 'notice', ...}
npm install
npm test
[sudo] docker build --no-cache -t node-gelf-pro .
[sudo] docker run -ti --rm -v " ${PWD} :/opt/app " -w " /opt/app " node-gelf-pro
麻省理工学院