伐木

Monitor your Edge Functions with logging to track execution, debug issues, and optimize performance.

每次函数调用都会提供日志，无论是在本地还是在托管环境中。

🌐 Logs are provided for each function invocation, locally and in hosted environments.

正在访问日志 #

🌐 Accessing logs

生产 #

🌐 Production

从仪表板的功能部分访问日志：

🌐 Access logs from the Functions section of your Dashboard:

导航到仪表板的功能部分
从列表中选择你的功能
选择你的日志视图：
- 调用信息: 请求/响应数据，包括头信息、正文、状态码和执行时长。可以按日期、时间或状态码筛选。
- 日志: 平台事件、未捕获的异常和自定义日志消息。可以按时间戳、级别或消息内容过滤。

Function invocations.

发展 #

🌐 Development

当你在本地开发时，你会在本地终端窗口看到错误信息和控制台日志。

🌐 When developing locally you will see error messages and console log statements printed to your local terminal window.

日志事件类型 #

🌐 Log event types

自动日志 #

🌐 Automatic logs

你的函数会自动捕获几种类型的事件：

🌐 Your functions automatically capture several types of events:

未捕获的异常：函数在执行过程中抛出的未捕获异常会自动记录。你可以在日志工具中查看错误信息和堆栈跟踪。
自定义日志事件：你可以在代码中使用 console.log、console.error 和 console.warn 来发出自定义日志事件。这些事件也会出现在日志工具中。
启动和关机日志：日志工具的覆盖范围扩展到包括函数的启动和关机日志。

自定义日志 #

🌐 Custom logs

你可以用标准控制台方法添加自己的日志信息：

🌐 You can add your own log messages using standard console methods:

1
Deno.serve(async (req) => {
2
  try {
3
    const { name } = await req.json()
4
5
    if (!name) {
6
      // Log a warning message
7
      console.warn('Empty name parameter received')
8
    }
9
10
    // Log a message
11
    console.log(`Processing request for: ${name}`)
12
13
    const data = {
14
      message: `Hello ${name || 'Guest'}!`,
15
    }
16
17
    return new Response(JSON.stringify(data), {
18
      headers: { 'Content-Type': 'application/json' },
19
    })
20
  } catch (error) {
21
    // Log an error message
22
    console.error(`Request processing failed: ${error.message}`)
23
    return new Response(JSON.stringify({ error: 'Internal Server Error' }), {
24
      status: 500,
25
      headers: { 'Content-Type': 'application/json' },
26
    })
27
  }
28
})

自定义日志消息最多可以包含10,000个字符。一个函数在10秒内最多可以记录100个事件。

🌐 A custom log message can contain up to 10,000 characters. A function can log up to 100 events within a 10 second period.

记录小贴士 #

🌐 Logging tips

记录请求头 #

🌐 Logging request headers

在调试 Edge Functions 时，一个常见错误是尝试通过这样的代码把 headers 打到开发者控制台:

🌐 When debugging Edge Functions, a common mistake is to try to log headers to the developer console via code like this:

1
// ❌ This doesn't work as expected
2
3
Deno.serve(async (req) => {
4
  console.log(`Headers: ${JSON.stringify(req.headers)}`) // Outputs: "{}"
5
})

req.headers 对象看起来是空的，因为 Headers 对象不会将数据存储在可枚举的 JavaScript 属性中，这使得它们对 JSON.stringify() 来说是不可见的。

🌐 The req.headers object appears empty because Headers objects don't store data in enumerable JavaScript properties, making them opaque to JSON.stringify().

相反，你得先把 headers 转成普通对象，比如用 Object.fromEntries。

🌐 Instead, you have to convert headers to a plain object first, for example using Object.fromEntries.

1
// ✅ This works correctly
2
Deno.serve(async (req) => {
3
  const headersObject = Object.fromEntries(req.headers)
4
  const headersJson = JSON.stringify(headersObject, null, 2)
5
6
  console.log(`Request headers:\n${headersJson}`)
7
})

这就会得到类似这样的结果：

🌐 This results in something like:

1
Request headers: {
2
    "accept": "*/*",
3
    "accept-encoding": "gzip",
4
    "authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InN1cGFuYWNobyIsInJvbGUiOiJhbm9uIiwieW91IjoidmVyeSBzbmVha3ksIGh1aD8iLCJpYXQiOjE2NTQ1NDA5MTYsImV4cCI6MTk3MDExNjkxNn0.cwBbk2tq-fUcKF1S0jVKkOAG2FIQSID7Jjvff5Do99Y",
5
    "cdn-loop": "cloudflare; subreqs=1",
6
    "cf-ew-via": "15",
7
    "cf-ray": "8597a2fcc558a5d7-GRU",
8
    "cf-visitor": "{\"scheme\":\"https\"}",
9
    "cf-worker": "supabase.co",
10
    "content-length": "20",
11
    "content-type": "application/x-www-form-urlencoded",
12
    "host": "edge-runtime.supabase.com",
13
    "my-custom-header": "abcd",
14
    "user-agent": "curl/8.4.0",
15
    "x-deno-subhost": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6InN1cGFiYXNlIn0.eyJkZXBsb3ltZW50X2lkIjoic3VwYW5hY2hvX2M1ZGQxMWFiLTFjYmUtNDA3NS1iNDAxLTY3ZTRlZGYxMjVjNV8wMDciLCJycGNfcm9vdCI6Imh0dHBzOi8vc3VwYWJhc2Utb3JpZ2luLmRlbm8uZGV2L3YwLyIsImV4cCI6MTcwODYxMDA4MiwiaWF0IjoxNzA4NjA5MTgyfQ.-fPid2kEeEM42QHxWeMxxv2lJHZRSkPL-EhSH0r_iV4",
16
    "x-forwarded-host": "edge-runtime.supabase.com",
17
    "x-forwarded-port": "443",
18
    "x-forwarded-proto": "https"
19
}