package syslog
import "log/syslog"
Package syslog 为系统日志服务提供了一个简单的接口。 它可以使用 UNIX 域套接字、UDP 或 TCP 向 syslog 守护进程 发送消息。
只需调用一次 Dial。当写入失败时, syslog 客户端会尝试重新连接服务器 并再次写入。
syslog 包已被冻结,不再接受新特性。 一些外部包提供了更多功能。参见:
https://godoc.org/?q=syslog
Index
- func NewLogger(p Priority, logFlag int) (*log.Logger, error)
- type Priority
-
type Writer
- func Dial(network, raddr string, priority Priority, tag string) (*Writer, error)
- func New(priority Priority, tag string) (*Writer, error)
- func (w *Writer) Alert(m string) error
- func (w *Writer) Close() error
- func (w *Writer) Crit(m string) error
- func (w *Writer) Debug(m string) error
- func (w *Writer) Emerg(m string) error
- func (w *Writer) Err(m string) error
- func (w *Writer) Info(m string) error
- func (w *Writer) Notice(m string) error
- func (w *Writer) Warning(m string) error
- func (w *Writer) Write(b []byte) (int, error)
Examples
Functions
func NewLogger
func NewLogger(p Priority, logFlag int) (*log.Logger, error)
NewLogger 创建一个 log.Logger,其输出以指定的优先级 (syslog 设施和严重级别的组合)写入系统日志服务。 logFlag 参数是创建该 Logger 时传给 log.New 的标志集。
Types
type Priority
type Priority int
Priority 是 syslog 设施(facility)和严重级别(severity)的组合。 例如,LOG_ALERT | LOG_FTP 从 FTP 设施发送一条 alert 严重级别的 消息。默认严重级别是 LOG_EMERG; 默认设施是 LOG_KERN。
const ( // 来自 /usr/include/sys/syslog.h。 // 这些在 Linux、BSD 和 OS X 上是相同的。 LOG_EMERG Priority = iota LOG_ALERT LOG_CRIT LOG_ERR LOG_WARNING LOG_NOTICE LOG_INFO LOG_DEBUG )
const ( // 来自 /usr/include/sys/syslog.h。 // 在 Linux、BSD 和 OS X 上,直到 LOG_FTP 都是相同的。 LOG_KERN Priority = iota << 3 LOG_USER LOG_MAIL LOG_DAEMON LOG_AUTH LOG_SYSLOG LOG_LPR LOG_NEWS LOG_UUCP LOG_CRON LOG_AUTHPRIV LOG_FTP LOG_LOCAL0 LOG_LOCAL1 LOG_LOCAL2 LOG_LOCAL3 LOG_LOCAL4 LOG_LOCAL5 LOG_LOCAL6 LOG_LOCAL7 )
type Writer
type Writer struct { // contains filtered or unexported fields }
Writer 是与 syslog 服务器的连接。
func Dial
func Dial(network, raddr string, priority Priority, tag string) (*Writer, error)
Dial 通过连接到指定网络上的地址 raddr 来建立一条到日志守护进程的
连接。对返回的 writer 的每次写入都会使用设施和严重级别
(来自 priority)以及 tag 发送一条日志消息。如果 tag 为空,
则使用 os.Args[0]。如果 network 为空,Dial 将连接到本地 syslog
服务器。否则,有关 network 和 raddr 的有效值,
请参阅 net.Dial 的文档。
Example
package main
import (
"fmt"
"log"
"log/syslog"
)
func main() {
sysLog, err := syslog.Dial("tcp", "localhost:1234",
syslog.LOG_WARNING|syslog.LOG_DAEMON, "demotag")
if err != nil {
log.Fatal(err)
}
fmt.Fprintf(sysLog, "This is a daemon warning with demotag.")
sysLog.Emerg("And this is a daemon emergency with demotag.")
}
func New
func New(priority Priority, tag string) (*Writer, error)
New 建立一条到系统日志守护进程的新连接。对返回的 writer 的 每次写入都会使用给定的优先级(syslog 设施和严重级别的组合) 和前缀 tag 发送一条日志消息。如果 tag 为空, 则使用 os.Args[0]。
func (*Writer) Alert
func (w *Writer) Alert(m string) error
Alert 以严重级别 LOG_ALERT 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Close
func (w *Writer) Close() error
Close 关闭到 syslog 守护进程的连接。
func (*Writer) Crit
func (w *Writer) Crit(m string) error
Crit 以严重级别 LOG_CRIT 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Debug
func (w *Writer) Debug(m string) error
Debug 以严重级别 LOG_DEBUG 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Emerg
func (w *Writer) Emerg(m string) error
Emerg 以严重级别 LOG_EMERG 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Err
func (w *Writer) Err(m string) error
Err 以严重级别 LOG_ERR 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Info
func (w *Writer) Info(m string) error
Info 以严重级别 LOG_INFO 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Notice
func (w *Writer) Notice(m string) error
Notice 以严重级别 LOG_NOTICE 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Warning
func (w *Writer) Warning(m string) error
Warning 以严重级别 LOG_WARNING 记录一条消息,忽略 传给 New 的严重级别。
func (*Writer) Write
func (w *Writer) Write(b []byte) (int, error)
Write 向 syslog 守护进程发送一条日志消息。