ログの発行

Add custom logging statements to your Cloud Code scripts and modules to record debugging information.

読み終わるまでの所要時間 3 分

最終更新 9ヶ月前

Cloud Code C# モジュール

Microsoft.Extensions.Logging

ライブラリを使用して、Cloud Code C# モジュールからログを発行できます。Cloud Code は、依存性注入を通じて

ILogger

をリクエストするたびに、UGS Logger にコードを自動的に提供します。

以下のコードサンプルは、C# モジュールをインストルメント化するために行う必要があるすべてのことを示します。


using Microsoft.Extensions.Logging;using Unity.Services.CloudCode.Core;namespace CloudCodeModules;public class LoggingExample{    // Setting up the Dependency Injection. Cloud Code will inject a UGS Logger    // into "_logger" which can then be used by all methods in this class    private readonly ILogger<LoggingExample> _logger;    public LoggingExample(ILogger<LoggingExample> logger)    {        _logger = logger;    }    [CloudCodeFunction("SayHello")]    public string SayHello(IExecutionContext ctx, string name)    {        // Logging out a standard message        _logger.LogDebug("received a request to SayHello");        // Logging out a templated message. The template variable "name"        // will be available as a key-value pair inside the log attributes map.        // Templated keys cannot use dot notation for namespacing.        _logger.LogInformation("saying hello to {name}", name);        // A scope can be used to share sets of attributes between multiple log        // entries. Attribute keys in a scope can use dot notation for namespacing        // purposes.        using (_logger.BeginScope(new Dictionary<string, object>            {                {"example.someInteger", 7 },                {"example.someString", "frog blast the vent core!" }            }))        {            _logger.LogInformation("logging within a scope");            _logger.LogInformation("logging again with the same attributes");        }        return $"Hello, {name}!";    }}

Cloud Code JavaScript スクリプト

スクリプトコンテキストの一部として自動的に提供されるデフォルトロガーを使用して、Cloud Code JavaScript スクリプトからログを発行できます。

以下のコードサンプルは、JavaScript スクリプトをインストルメント化するために行う必要があるすべてのことを示します。

JavaScript


module.exports = async ({ params, context, logger }) => {    logger.info("script executing", {"example.someString": "frog blast the vent core!"});    logger.warning("this is a serious warning that the cheese is about to run out.");    logger.error("out of cheese :(", {"example.foo": 42}, {"example.bar": 7});};

ロガーでは以下のメソッドが提供されています。

```
debug(message, ...logAttributes)
```
```
info(message, ...logAttributes)
```
```
warning(message, ...logAttributes)
```
```
error(message, ...logAttributes)
```
```
fatal(message, ...logAttributes)
```

制限

呼び出しごとに複数のログ属性を渡すことができますが、以下の制限が適用されます。

各ログ属性は、単一のキー/値のペアを持つオブジェクトである必要があります。
値は空ではないプリミティブである必要があります (false ブーリアンが許可されます)。

ドキュメント

Development

User Acquisition

Monetization

産業