package syslog

import "log/syslog"

Package syslog 为系统日志服务提供了一个简单的接口。 它可以使用 UNIX 域套接字、UDP 或 TCP 向 syslog 守护进程 发送消息。

只需调用一次 Dial。当写入失败时, syslog 客户端会尝试重新连接服务器 并再次写入。

syslog 包已被冻结,不再接受新特性。 一些外部包提供了更多功能。参见:

https://godoc.org/?q=syslog

Index

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 守护进程发送一条日志消息。