moonbitstack/moonzero/logx

README
U
Balancer
U
BidiCall
U
BidiStreamFactory
U
BidiStreamHandler
U
Breaker
U
ClientStreamHandler
U
Clock
U
Conf
U
ConfigError
U
ConsulClient
U
ConsulDiscovery
U
ConsulError
U
ConsulHttp
U
ConsulResponse
U
CorsConf
U
CounterVec
U
Endpoint
U
EtcdClient
U
EtcdDeleteRangeRequest
U
EtcdDeleteRangeResponse
U
EtcdDiscovery
U
EtcdError
U
EtcdEvent
U
EtcdEventType
U
EtcdKeyValue
U
EtcdLeaseGrantRequest
U
EtcdLeaseGrantResponse
U
EtcdLeaseKeepAliveRequest
U
EtcdLeaseKeepAliveResponse
U
EtcdPutRequest
U
EtcdPutResponse
U
EtcdRangeRequest
U
EtcdRangeResponse
U
EtcdWatchCancelRequest
U
EtcdWatchCreateRequest
U
EtcdWatchRequest
U
EtcdWatchResponse
U
Group
U
Histogram
U
InMemoryRegistry
U
Layer
U
LoadBalancedChannel
U
LogLevel
U
Logger
U
ManualClock
U
MaxConns
U
Middleware
U
MiddlewaresConf
U
PeriodLimit
U
PeriodResult
U
PersistentRegistry
U
PrivateKeyConf
U
Promise
U
RedisClient
U
RedisConn
U
RedisDiscovery
U
RedisError
U
RedisPeriodLimit
U
RedisScript
U
RedisTokenLimit
U
Refusal
U
RegistryEvent
U
RequestLog
U
Resolve
U
RespError
U
RespReader
U
RespValue
U
RestConf
U
RestEngine
U
RoundRobin
U
RpcChannel
U
RpcCluster
U
RpcGroup
U
RpcHandler
U
RpcServer
U
RpcServerConf
U
Server
U
ServerMetrics
U
ServerStreamHandler
U
ServiceConf
U
Shedder
U
ShutdownCoordinator
U
SignatureConf
U
Ticket
U
TokenBucket
U
TraceContext
U
Unavailable
U
WeightedRoundRobin
V
auth
V
breaker
V
canonical_key
V
consul_check_id
V
consul_parse_health
V
consul_register_body
V
cors
V
default_latency_buckets
V
duration_key
V
entry
V
etcd_prefix_end
V
etcd_service_prefix
V
exposition_content_type
V
generate_span_id
V
generate_trace_id
V
jwt_authorized
V
jwt_sign
V
jwt_verify
V
level_name
V
logging
V
logx
V
max_conns
V
maxbytes
V
message_key
V
metrics
V
metrics_handler
V
mount_metrics
V
next_trace_context
V
parse_traceparent
V
period_limit
V
period_script
V
pick_first
V
plain_text
V
port
V
rate_limit
V
recovery
V
redis_instance_key
V
redis_period_limit
V
redis_rate_limit
V
redis_service_pattern
V
redis_service_prefix
V
refusal
V
request_id
V
resolve_one
V
resp_command
V
resp_encode_command
V
resp_kind
V
rpc_port
V
set_log_level
V
set_log_sink
V
set_log_writer
V
shedding
V
stamp_key
V
status_of_code
V
structured_logging
V
timed_out
V
timeout
V
token_script
V
too_large
V
too_many
V
tracing
V
unavailable

moonbitstack/moonzero/logx does not have a README file

LogLevel

pub(all) enum LogLevel {
  Debug
  Info
  Error
  Severe
} derive(Compare, Eq, @moonbitlang/core/debug.Debug
Debug)

Log verbosity (← go-zero's LogConf.Level), ordered from most to least verbose. Compare follows that order so thresholds can be tested directly.

impl FromJson for LogLevel

fn from_json(json : Json, path : @moonbitlang/core/json.JsonPath
JsonPath) -> LogLevel raise @moonbitlang/core/json.JsonDecodeError
JsonDecodeError

source

Decode a LogLevel from a JSON string ("debug"/"info"/"error"/ "severe"), reusing LogLevel::parse's lenient fallback to Info. This impl lets ServiceConf's derived FromJson read log_level as a plain string — the way go-zero writes it in YAML/JSON config — instead of a tagged variant.

LogLevel::as_level

source

fn LogLevel::as_level(self : LogLevel) -> @moonbitstack/moonlog.Level
Level

The moonlog level this one records as. go-zero's ladder has four rungs and moonlog's has six, so the map is one-way: Severe records as Fatal, and [level_name] writes it back out as severe.

LogLevel::compare

source

fn LogLevel::compare(LogLevel, LogLevel) -> Int

LogLevel::equal

source

fn LogLevel::equal(LogLevel, LogLevel) -> Bool

LogLevel::from_json

source

fn LogLevel::from_json(json : Json, path : @moonbitlang/core/json.JsonPath
JsonPath) -> LogLevel raise @moonbitlang/core/json.JsonDecodeError
JsonDecodeError

LogLevel::not_equal

source

fn LogLevel::not_equal(x : LogLevel, y : LogLevel) -> Bool

LogLevel::op_ge

source

fn LogLevel::op_ge(x : LogLevel, y : LogLevel) -> Bool

LogLevel::op_gt

source

fn LogLevel::op_gt(x : LogLevel, y : LogLevel) -> Bool

LogLevel::op_le

source

fn LogLevel::op_le(x : LogLevel, y : LogLevel) -> Bool

LogLevel::op_lt

source

fn LogLevel::op_lt(x : LogLevel, y : LogLevel) -> Bool

LogLevel::parse

source

fn LogLevel::parse(s : String) -> LogLevel

Parse a level name, falling back to Info for anything unrecognised — the same lenient default go-zero applies to a missing/empty level.

LogLevel::to_repr

source

fn LogLevel::to_repr(LogLevel) -> @moonbitlang/core/debug.Repr
Repr

LogLevel::to_string

source

fn LogLevel::to_string(self : LogLevel) -> String

The canonical lowercase name go-zero uses on the wire.

LogState

source

type LogState

The bits of a logger that are shared by every view derived from it, so set_level on the process logger is seen by a with_duration view taken before it (← logx's package-level level and writer).

Logger

source

pub struct Logger {
  state : LogState
  clock : @moonbitstack/moonzero/clock.Clock
Clock
  duration_ms : Int64?
}

A leveled, structured logger (← go-zero's logx): entries below the configured level are dropped without being rendered, and everything else reaches the sink as one record carrying @timestamp, level, content, an optional duration, and any extra fields.

The timestamp is milliseconds from the injected Clock, not a formatted calendar time: MoonBit has no portable date formatter, and the clock is already how every other timed layer here reads the time.

Logger::debug

source

fn Logger::debug(self : Logger, content : String, fields? : Array[(String, Json)]) -> Unit

Write a debug entry.

Logger::enabled

source

fn Logger::enabled(self : Logger, level : LogLevel) -> Bool

Whether an entry at level would be written.

Logger::error

source

fn Logger::error(self : Logger, content : String, fields? : Array[(String, Json)]) -> Unit

Write an error entry.

Logger::info

source

fn Logger::info(self : Logger, content : String, fields? : Array[(String, Json)]) -> Unit

Write an info entry.

Logger::level

source

fn Logger::level(self : Logger) -> LogLevel

The level below which entries are dropped.

Logger::log

source

fn Logger::log(self : Logger, level : LogLevel, content : String, fields? : Array[(String, Json)]) -> Unit

Render and write one entry, unless level is below the threshold.

Logger::new

source

fn Logger::new(clock : @moonbitstack/moonzero/clock.Clock
Clock, level? : LogLevel, sink? : &@moonbitstack/moonlog.Sink
Sink) -> Logger

A logger writing to sink at level and above.

The default sink prints one [entry] per line. Logger::new(clock,sink=@moonlog.Discard::{ }) is how a test silences one.

Logger::set_level

source

fn Logger::set_level(self : Logger, level : LogLevel) -> Unit

Raise or lower the threshold (← logx.SetLevel), for this logger and every view derived from it.

Logger::set_sink

source

fn Logger::set_sink(self : Logger, sink : &@moonbitstack/moonlog.Sink
Sink) -> Unit

Send entries to another sink, for this logger and every view derived from it — a file, a collector client, a buffer under test.

Logger::set_writer

source

fn Logger::set_writer(self : Logger, writer : (String) -> Unit) -> Unit

Send entries somewhere other than stdout (← logx.SetWriter), keeping go-zero's line format. [Logger::set_sink] changes the format too.

Logger::severe

source

fn Logger::severe(self : Logger, content : String, fields? : Array[(String, Json)]) -> Unit

Write a severe entry.

Logger::with_duration

source

fn Logger::with_duration(self : Logger, ms : Int64) -> Logger

A view of this logger that stamps duration on every entry (← logx.WithDuration), sharing the level and sink with the original.

duration_key

source

let duration_key : String

The key the elapsed time is written under.

entry

source

fn entry(record : @moonbitstack/moonlog.Record
Record) -> String

One entry as the single-line JSON object go-zero emits: @timestamp, level, content, then whatever else the entry carries.

This is the default sink's format, not a rule — hand Logger::new another moonlog sink and the same records are rendered that sink's way.

level_name

source

fn level_name(level : @moonbitstack/moonlog.Level
Level) -> String

go-zero's name for a level. Fatal reads as severe, which is what go-zero calls its top level and what its collectors filter on.

logx

source

let logx : Logger

The process-wide logger (← logx's package-level logger): what the middlewares write to when no logger is handed to them, on the system clock at info. RestEngine::new points its level at the loaded Log.Level.

message_key

source

let message_key : String

The key the message is written under (← go-zero's logx.content, where zap and slog would write msg).

set_log_level

source

fn set_log_level(level : LogLevel) -> Unit

Set the process logger's level (← logx.SetLevel).

set_log_sink

source

fn set_log_sink(sink : &@moonbitstack/moonlog.Sink
Sink) -> Unit

Send the process logger's entries to sink.

set_log_writer

source

fn set_log_writer(writer : (String) -> Unit) -> Unit

Send the process logger's entries to writer (← logx.SetWriter).

stamp_key

source

let stamp_key : String

The key the entry's time is written under (← go-zero's logx, which names it for Elasticsearch's own field).

Source Files

Site source Report issue Packages Build queue Skills Statistics

#LogLevel

#LogLevel::as_level

#LogLevel::compare

#LogLevel::equal

#LogLevel::from_json

#LogLevel::not_equal

#LogLevel::op_ge

#LogLevel::op_gt

#LogLevel::op_le

#LogLevel::op_lt

#LogLevel::parse

#LogLevel::to_repr

#LogLevel::to_string

#LogState

#Logger

#Logger::debug

#Logger::enabled

#Logger::error

#Logger::info

#Logger::level

#Logger::log

#Logger::new

#Logger::set_level

#Logger::set_sink

#Logger::set_writer

#Logger::severe

#Logger::with_duration

#duration_key

#entry

#level_name

#logx

#message_key

#set_log_level

#set_log_sink

#set_log_writer

#stamp_key

Source Files

LogLevel

LogLevel::as_level

LogLevel::compare

LogLevel::equal

LogLevel::from_json

LogLevel::not_equal

LogLevel::op_ge

LogLevel::op_gt

LogLevel::op_le

LogLevel::op_lt

LogLevel::parse

LogLevel::to_repr

LogLevel::to_string

LogState

Logger

Logger::debug

Logger::enabled

Logger::error

Logger::info

Logger::level

Logger::log

Logger::new

Logger::set_level

Logger::set_sink

Logger::set_writer

Logger::severe

Logger::with_duration

duration_key

entry

level_name

logx

message_key

set_log_level

set_log_sink

set_log_writer

stamp_key