全部产品
云市场

.NET Core 运行环境

更新时间:2019-04-09 15:53:10

函数计算支持 .net core 2.1(runtime = dotnetcore2.1)运行环境, 编写函数的语言为 C# 。本文主要介绍 dotnetcore2.1 运行环境相关内容:

使用 logger

C# 函数通过 context.Logger 打印的内容会被收集到创建服务时指定的日志服务 Logstore 中。

日志级别

您可以通过改变 logger 的 property EnabledLogLevel 达到改变日志级别目的,其中有如下几种从高到低的日志级别:

日志级别 Level 接口
Critical 5 context.Logger.LogCritical
Error 4 context.Logger.LogError
Warning 3 context.Logger.LogWarning
Information 2 context.Logger.LogInformation
Debug 1 context.Logger.LogDebug
Trace 0 context.Logger.LogTrace

更多有关日志 Level 的信息, 请参考:LogLevel Enum

更多有关函数日志的详情,请参阅 函数日志

logger 示例一

  1. using System;
  2. using System.IO;
  3. using System.Text;
  4. using Aliyun.Serverless.Core;
  5. using Microsoft.Extensions.Logging;
  6. namespace FC.Examples
  7. {
  8. public class TestLogger
  9. {
  10. public Stream Echo(Stream input, IFcContext context)
  11. {
  12. context.Logger.LogInformation(string.Format("detail = {0} ", "hello world"));
  13. using (MemoryStream output = new MemoryStream(100))
  14. {
  15. byte[] hello = Encoding.UTF8.GetBytes("hello world");
  16. output.Write(hello, 0, hello.Length);
  17. return output;
  18. }
  19. }
  20. }
  21. }

输出的日志内容为:

  1. 2019-03-15T03:09:59.812Z 8ba1a2a2-0eb7-9e79-c3c6-ee6606c5beaf [INFO] detail = hello world

logger 示例二

  1. using System;
  2. using System.IO;
  3. using System.Text;
  4. using Aliyun.Serverless.Core;
  5. using Microsoft.Extensions.Logging;
  6. namespace FC.Examples
  7. {
  8. public class TestLogger
  9. {
  10. public Stream Echo(Stream input, IFcContext context)
  11. {
  12. context.Logger.EnabledLogLevel = LogLevel.Error;
  13. context.Logger.LogError("console error 1");
  14. context.Logger.LogInformation("console info 1");
  15. context.Logger.LogWarning("console warn 1");
  16. context.Logger.LogDebug("console debug 1");
  17. context.Logger.EnabledLogLevel = LogLevel.Warning;
  18. context.Logger.LogError("console error 2");
  19. context.Logger.LogInformation("console info 2");
  20. context.Logger.LogWarning("console warn 2");
  21. context.Logger.LogDebug("console debug 2");
  22. context.Logger.EnabledLogLevel = LogLevel.Information;
  23. using (MemoryStream output = new MemoryStream(100))
  24. {
  25. byte[] hello = Encoding.UTF8.GetBytes("hello world");
  26. output.Write(hello, 0, hello.Length);
  27. return output;
  28. }
  29. }
  30. }
  31. }

输出的日志内容为:

  1. 2019-03-15T03:09:31.047Z f4ddc314-d3e9-91c9-b774-4b08c91a977d [ERROR]: console error 1
  2. 2019-03-15T03:09:31.047Z f4ddc314-d3e9-91c9-b774-4b08c91a977d [ERROR]: console error 2
  3. 2019-03-15T03:09:31.047Z f4ddc314-d3e9-91c9-b774-4b08c91a977d [WARNING]: console warn 2

使用第三方库

C# 编写的函数使用第三方库十分简单

  • 直接编辑对应的 project 的 .csproj 文件, 增加对应的package, 比如:

    1. <ItemGroup>
    2. <PackageReference Include="Aliyun.Serverless.Core" Version="1.0.1" />
    3. <PackageReference Include="Aliyun.OSS.SDK.NetCore" Version="2.9.1" />
    4. </ItemGroup>
  • 使用 Visual Studio IDE, 直接 GUI 操作添加对应 Nuget 包

错误处理

C# 函数在执行过程中发生异常时,函数计算捕获异常并返回异常信息。以下示例代码返回了 oops 的异常信息:

  1. using System;
  2. using System.IO;
  3. using Aliyun.Serverless.Core;
  4. namespace FC.Examples
  5. {
  6. public class TestException
  7. {
  8. public Stream Echo(Stream input, IFcContext context)
  9. {
  10. throw new Exception("oops");
  11. }
  12. }
  13. }

根据以上示例代码,您调用函数时可能收到如下响应信息:

  1. {
  2. "ErrorMessage": "oops",
  3. "ErrorType": "System.Exception",
  4. "StackTrace": [...]
  5. }

发生异常时,函数调用的响应的 HTTP header 中会包含 X-Fc-Error-Type: UnhandledInvocationError。更多有关函数计算的错误类型,请参阅 错误类型