登录 Go

Fuchsia 上的 Go 程序通常使用 syslog 软件包及其 syslog.Infof() 函数。

如需详细了解如何记录和查看日志，请参阅与语言无关的日志记录文档。

要求

GN 依赖项

作为 deps 的补充，在 BUILD.gn 中可以包含必要的软件包：

deps = [
    "//src/lib/component",
    "//src/lib/syslog/go",
]

如需详细了解如何在 Fuchsia 中构建 Go，请参阅 Go：概览。

组件清单依赖项

通过在组件清单中添加以下代码，确保您的组件具有记录所需的功能：

{
  include: [
    "syslog/client.shard.cml"
  ],
  ...
}

如果 LogSink 连接失败，syslog 库将回退到 stderr。

初始化

在没有任何标记的情况下进行初始化将默认使用进程名称。

import (
    "go.fuchsia.dev/fuchsia/src/lib/component"
    syslog "go.fuchsia.dev/fuchsia/src/lib/syslog/go"
)

func main() {
  ctx := component.NewContextFromStartupInfo()
  {
    // Global tags, max 4 tags can be passed. Every log message is tagged with these.
    l, err := syslog.NewLoggerWithDefaults(ctx.Connector(), "my_tag")
    if err != nil {
      panic(err)
    }
    syslog.SetDefaultLogger(l)
  }
}

录制消息

日志方法有两个变体：Levelf 和 LevelTf（例如 Infof 和 InfoTf）。带有 T 的每种方法的变体都接受消息的额外标记。

syslog.Infof("my msg: %d", 10);          // maps to INFO

// Allow message specific tagging. This message is going to be tagged with
// this local tag and any global tag passed during initialization.
syslog.InfoTf("tag", "my msg: %d", 10);

syslog.Warnf("my msg: %d", 10);          // maps to WARN
syslog.WarnTf("tag", "my msg: %d", 10);

syslog.Errorf("my msg: %d", 10);         // maps to ERROR
syslog.ErrorTf("tag", "my msg: %d", 10);

syslog.Fatalf("my msg: %d", 10);         // maps to FATAL
syslog.FatalTf("tag", "my msg: %d", 10);

标准信息流

fmt.Printf()、fmt.Sprintf() 等转至标准输出 (stdout) 和标准错误 (stderr)。

如需详细了解系统中标准流的路由，请参阅与语言无关的日志记录文档中的 stdout 和 stderr。