登入 Go

Fuchsia 中的 Go 程式通常使用系統記錄檔套件及其 syslog.Infof() 函式。

如要進一步瞭解如何記錄及查看記錄，請參閱語言診斷記錄文件。

相關規定

GN 依附元件

在 BUILD.gn 中，除了 deps 以外，還可以納入必要的套件：

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

如要進一步瞭解如何在 Fuchsia 中建構 Go，請參閱「Go：總覽」。

元件資訊清單依附元件

在元件資訊清單中加入以下內容，確保元件具有可記錄的必要功能：

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

如果 LogSink 連線失敗，系統記錄檔程式庫將恢復為 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)。

如要進一步瞭解系統中的 stdio 串流轉送方式，請參閱語言通用記錄文件中的 stdout 和 stderr。