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
。