ドキュメント

サポート

Cloud Code

Open Unity Dashboard

Cloud Code

ログの発行

Add custom logging statements to your Cloud Code scripts and modules to record debugging information.
読み終わるまでの所要時間 1 分最終更新 23日前
Cloud Code スクリプト と モジュール からログを発行できます。

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 ブーリアンが許可されます)。