本文介绍安装日志服务.NET SDK及使用.NET SDK完成常见操作的相关步骤。

前提条件

  • 已开通日志服务。更多信息，请参见开通日志服务。
  • 已创建并获取AccessKey。更多信息，请参见访问密钥。
  • 已安装.NET开发环境。
    日志服务.NET SDK支持.NET 3.5、4.0、4.5运行环境。推荐安装如下版本：
    • Microsoft .NET Framework 3.5、4.0、4.5。
    • Visual Studio 2010及以上版本。

步骤1：安装.NET SDK

您可以通过项目引入方式安装.NET SDK，此处以通过Visual Studio 2019安装.NET SDK为例。

  1. 下载.NET SDK。
  2. 解压安装包aliyun-log-csharp-sdk-master.zip到指定目录。
  3. 使用Visual Studio 2019打开aliyun-log-csharp-sdk-master\LOGSDKSample\LOGSDKSample.csproj文件，执行调试安装。

步骤2：创建日志服务Client

LogClient是日志服务的C#客户端，用于管理Project、Logstore等日志服务资源。使用.Net SDK发起日志服务请求，您需要初始化一个Client实例。
String endpoint = "cn-hangzhou.log.aliyuncs.com",   //日志服务的域名。更多信息，请参见服务入口。此处以杭州为例，其它地域请根据实际情况填写。
accesskeyId = "your accesskey id",  //阿里云访问密钥AccessKey ID。更多信息，请参见访问密钥。阿里云主账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维。
accessKey = "your access key",      //阿里云访问密钥AccessKey Secret。
LogClient client = new LogClient(endpoint, accesskeyId, accessKey);

.NET SDK示例

日志服务.NET SDK提供丰富的示例程序，方便参考或直接使用，更多信息，请参见aliyun-log-csharp-sdk。此处以写入日志为例进行说明，示例代码如下所示：
PutLogsRequest putLogsReqError = new PutLogsRequest();
            putLogsReqError.Project = my-project;   //Project名称
            putLogsReqError.Topic = "topic";      //日志主题
            putLogsReqError.Logstore = my-logstore; //Logstore名称
            putLogsReqError.LogItems = new List<LogItem>();
            for (int i = 1; i <= 10; ++i)
            {
                LogItem logItem = new LogItem();
                logItem.Time = DateUtils.TimeSpan();
                for (int k = 0; k < 10; ++k)
                    logItem.PushBack("error_" + i.ToString(), "invalid operation");
                putLogsReqError.LogItems.Add(logItem);
            }
            PutLogsResponse putLogRespError = client.PutLogs(putLogsReqError);

            Thread.Sleep(5000);