查看应用日志：实例的输出、每个请求一行、平台的操作

以下之一：

• LogOutput{9 个属性}

  • timestringrequired

    打印时间，UTC，精确到微秒：按实例自己的时钟，机器在创建和唤醒实例时会校准它，误差不超过机器对实例最近两次读取之间的时间。

    format: date-time
  • kindoutputrequired
  • instancestring | nullrequired

    打印它的实例，按 id。机器构建版本模板时启动命令打印的行为 null (from)。

  • versionstring | nullrequired

    实例所属版本的 id。

  • streamstdout或stderrrequired
  • textstringrequired

    该行内容，不含结束它的换行符以及之前的回车符。不是 UTF-8 的字节会被替换 (U+FFFD)。尚未结束的行，在其最后一个字节已过一秒，或其实例被停止或删除时，按已收到的部分给出。

  • cursorstringrequired

    读完这一行后读取方所处的位置。

  • cut_bytesoptionalinteger

    该行超出了机器为单行保留的长度（默认 16,384 字节，除非机器另有设置）：此值为从末尾截掉的字节数。

    minimum: 1
  • fromoptionaltemplate

    该行是在机器构建版本模板时、模板保存之前打印的：该机器上的每个实例都从这一行之后开始，它不属于任何实例。每台构建模板的机器各一次。

  }
• LogRequest{18 个属性}

  • timestringrequired

    响应的最后一个字节从实例发出的时间，或者机器拒绝该请求的时间。

    format: date-time
  • kindrequestrequired
  • instancestring | nullrequired

    请求交给的实例。null：没有交给任何实例 (refused)。

  • versionstring | nullrequired

    请求所针对的版本的 id。

  • request_idstringrequired

    请求的 id：请求自带的 X-Request-Id，或机器为它生成的 id。实例会在这个请求头中收到它，因此实例打印的内容可以像这一行一样指明是哪个请求。

  • methodstringrequired
  • pathstringrequired

    请求的路径，不含 ? 之后的部分，最多前 1024 个字节。

  • statusinteger | nullrequired

    响应的状态码：实例的，或者机器拒绝请求时机器自己的。null：实例没有响应就关闭了连接。

  • duration_msnumberrequired

    从机器读完请求头到响应的最后一个字节，单位为毫秒。请求等待实例的时间也包括在内。

    minimum: 0
  • bytesintegerrequired

    转发的响应字节数，包括响应头。

    minimum: 0
  • cursorstringrequired
  • refusedoptionalstring

    机器自己回答了该请求，错误码为：应用在那里已满（app_full_here：边缘节点随后会尝试另一台机器；app_at_capacity），或者实例无法接收该请求。

  • instance_wasoptionalpaused或asleep

    请求到来时实例没有在运行，为它启动了实例。

  • wake_msoptionalnumber

    与 instance_was 一起：请求等待实例启动的时间，单位为毫秒。

    minimum: 0
  • upgradedoptionaltrue

    响应为 101，连接随后被原样转发，直到关闭。

  • timesoptionalinteger

    对于拒绝：这一秒机器以该错误码拒绝了该版本多少个请求，这一行对应其中的第一个。

    minimum: 1
  • sample_rateoptionalnumber

    如果应用保留的请求比例低于 1：这一行代表的比例，读取方可以据此还原总数。1：请求失败了，失败的请求全部保留 (keep_errors)。

    maximum: 1 · minimum: 0
  • trace_idoptionalstring

    请求带有符合 W3C Trace Context 规范的 traceparent 请求头：其链路的 id。发给导出目标的这一行的记录中，它作为 TraceId。

    pattern: ^[0-9a-f]{32}$

  }
• LogPlatform{31 个属性}

  • timestringrequired

    format: date-time
  • kindplatformrequired
  • instancestring | nullrequired

    该行涉及的实例。null：涉及的是某台机器上的版本，或这次读取本身。

  • versionstring | nullrequired

    版本的 id。本调用对其所读取的机器的说明为 null。

  • eventstringrequired

    机器上：template.built（该版本的模板在那里构建完成；该行带有构建的时间）、version.served（机器被通知服务该版本）、version.removed（以及不再服务它，带 reason）、instance.made（took_ms、from_pool、kept）、instance.stopped（空闲实例被暂停或休眠：how、idle_ms、times；同一实例最多每秒说明一次）、instance.woken（静止的实例在没有请求的情况下被启动，因为应用要保持一定数量的实例运行：instance_was、wake_ms；由请求启动的实例没有这样的行，请求行会说明）、instance.retired（从此不再给该实例任何请求，手头的请求结束后它就会离开：reason）、instance.deleted（reason；实例的最后一行）、output.dropped（实例一秒内打印的行数超过了机器保留的上限：lines、bytes、reason）、output.lost（输出在机器读取之前就已从实例中消失：bytes、reason）、output.unavailable（实例来自平台开始保留启动命令输出之前的模板）、logs.keep_off 和 logs.keep_on（从此该版本的输出只保存在机器上、不长期保留，以及从此重新长期保留：reason）、logs.restarted（写这一行的程序之前的那个机器程序没有按顺序停止就结束了：它最后时刻尚未保存的请求行和平台行缺失，实例打印的内容会继续读取；last_seen）、logs.gap（机器在保存了单个应用的全部上限后，丢弃了尚未上传到对象存储的行：reason 为 node_buffer，from、to、lines、bytes；最多每秒说明一次）。本调用的：logs.incomplete、logs.complete、logs.anew (machines_unreachable)，以及 logs.gap（永久缺失的行：reason 为 node_gone、log_gone 或 unreadable，from、to、lines，时间为该时段的开始）。export.dropped（日志行没有导出到项目的某个导出目标 (/v1/destinations)：它们等待的时间超过了导出程序的上限，或者早于它能暂存的最后那部分：destination、destination_id、lines、from、to、reason；对于应用指标，未导出的是分钟，signal 为 metrics，用 minutes 代替 lines）。export.failing（某个导出目标在该机器上接收该应用的日志或指标时变为 failing：destination、destination_id、signal、since、error、next_try；每段失败期只说明一次，无论期间重试了多少次）以及 export.recovered（它重新接收了一批数据，失败期就此结束：destination、destination_id、signal、since，期间未发给它的 lines 或 minutes，rejected）。这三种都会作为一条记录发往其所指的导出目标，不发往其他目标。

  • messagestringrequired

    用一句话向人说明该事件。

  • cursorstringrequired
  • reasonoptionalstring

    原因。version_left：应用的流量已离开该版本，或者机器不再服务该应用。app_deleted：应用已被删除。broken：实例的端口不接受连接，或实例失败了。idle：空闲时间超过了实例的保留时长。deleted：被调用删除 (DELETE /v1/sandboxes/{id})，或被其机器删除而没有说明其他原因。丢弃输出的原因：rate_limit。丢失输出的原因：guest_buffer（两次读取之间打印的内容超过了实例的保留量）、deleted_unread（实例被就地删除，停止之前尚未交出的内容随之丢失）、agent_restarted（实例中保存输出的程序重新开始；丢失了多少无从得知）。logs.keep_off 和 logs.keep_on 的原因：setting（应用的 logs.keep）、over_plan（应用所属的账户已用完套餐包含的日志额度，且没有余额支付更多：这是控制平面的判断，即应用的 logs_over_plan）；对 logs.keep_on 而言，是结束的那个原因。logs.gap 的原因：node_buffer（机器已保存了单个应用的全部上限，而对象存储连不上）、node_gone（机器已从记录中消失）、log_gone（机器丢失了它为该应用保存的内容，或重新开始保存）、unreadable（对象存储中有一个分段无法读取）。export.dropped 的原因：destination_down（导出目标没有接收，或连不上）、destination_slow（它接收的速度慢于数据到来的速度）、egress_stopped（账户发往互联网的流量被停止了）、exporter_down（这些行还足够新时，机器上没有运行导出程序）、node_buffer（机器在导出目标接收之前丢弃了它们：应用已达到单个应用的全部保留上限）。

  • fromoptionalstring

    logs.gap：缺失的最早那一行的时间，或者从何时起缺失。export.dropped：未导出的最早那一行的时间。

    format: date-time
  • tooptionalstring

    logs.gap：缺失的最晚那一行的时间，或者缺失到何时为止。export.dropped：未导出的最晚那一行的时间。

    format: date-time
  • took_msoptionalnumber | null

    instance.made：创建所用的时间，单位为毫秒。

  • from_pooloptionalboolean | null

    instance.made：该实例是否为预先创建好、在等待的实例。

  • keptoptionalboolean

    instance.made：是否在没有请求的情况下创建，因为应用要保持一定数量的实例运行（其 scale 的 min_instances）。这种实例的日志不以请求开头。

  • howoptionalstring

    instance.stopped：就地暂停，或者保存内存并停止其虚拟机。

  • idle_msoptionalnumber

    instance.stopped：已空闲多久，单位为毫秒。

  • timesoptionalinteger

    instance.stopped：这一行代表多少次停止。

    minimum: 1
  • instance_wasoptionalpaused或asleep

    instance.woken：实例被启动时所处的状态。

  • wake_msoptionalnumber

    instance.woken：启动所用的时间，单位为毫秒。

    minimum: 0
  • linesoptionalinteger

    output.dropped：多少行。logs.gap：各类行合计缺失多少行；对 node_gone 和 log_gone 为最多缺失的行数。export.dropped：多少行没有导出。以上均为 1 或更多。日志的 export.recovered：导出目标失败期间有多少行没有发给它，被它拒绝或超出导出程序的上限；0 或更多。

    minimum: 0
  • bytesoptionalinteger | null

    output.dropped：这些行共有多少字节。output.lost：多少字节；不知道时为 null。node_buffer 的 logs.gap：其中输出行的 text 的字节数。

  • last_seenoptionalstring | null

    logs.restarted：之前的机器程序最后一次被看到在运行的时间，误差在一秒以内；它没有留下相关记录时为 null。

    format: date-time
  • machines_unreachableoptionalinteger

    logs.incomplete、logs.complete、logs.anew：保存该应用日志行的机器中，现在有多少台连不上。

    minimum: 0
  • destinationoptionalstring

    export.dropped、export.failing、export.recovered：导出目标的名称。

  • destination_idoptionalstring

    export.dropped、export.failing、export.recovered：导出目标的 id。

    pattern: ^dst-
  • signaloptionallogs或metrics或traces

    应用指标分钟数的 export.dropped：metrics。export.failing、export.recovered：导出目标接收的哪一类失败了：日志、指标或链路追踪。

  • minutesoptionalinteger

    指标的 export.dropped：多少分钟没有导出（from 为第一分钟的开始，to 为最后一分钟的结束），1 或更多。指标的 export.recovered：导出目标失败期间有多少分钟没有发给它，0 或更多。

    minimum: 0
  • spansoptionalinteger

    链路追踪的 export.recovered：导出目标失败期间，应用请求的 span 有多少个没有发给它，0 或更多。（未发送的 span 没有 export.dropped 行：请求自己的那一行在日志中。）

    minimum: 0
  • sinceoptionalstring

    export.failing、export.recovered：这段失败期中第一次失败的尝试是何时进行的；同一段失败期的两行给出的时间相同。

    format: date-time
  • erroroptionalobject{3 个属性}

    export.failing：导出目标在该机器上变为失败时出了什么问题，与其状态给出的一致 (last_error)。

    • codestringrequired

      用一个词说明原因：不会重发的响应（status、redirect），会重发且持续了一分钟的响应（status 为 429、502、503、504），不在公共互联网上的地址 (address)，持续一分钟无法连接 (unreachable) 或没有及时响应 (no_answer)。

    • statusinteger | nullrequired

      响应的状态码；null：没有响应。

    • messagestringrequired

      它说了什么，或者为什么没有响应，导出目标的所有请求头的值都已去掉；什么都没说时为空。

      maxLength: 512

    }
  • next_tryoptionalstring | null

    export.failing：下次尝试该导出目标的时间。

    format: date-time
  • rejectedoptionalinteger

    export.recovered：期间未发送的行（分钟、span）中有多少被导出目标拒绝；其余的则是等待时间超过了导出程序的暂存时长（行和分钟的 export.dropped）。

    minimum: 0

  }
• LogMark{3 个属性}

  • kindmarkrequired
  • cursorstringrequired
  • moreoptionalboolean

    这次读取已读满单次读取对象存储的上限，并在这里结束：游标之后还有更多内容，读取方可以接着读。

  }