OpenTracing C 项目教程

OpenTracing C# 项目教程

opentracing-csharpOpenTracing API for C# (.NET). 🛑 This library is DEPRECATED! https://github.com/opentracing/specification/issues/163项目地址:https://gitcode.com/gh_mirrors/op/opentracing-csharp

1. 项目的目录结构及介绍

OpenTracing C# 项目的目录结构如下：

opentracing-csharp/
├── examples/
├── src/
│   └── OpenTracing/
├── test/
│   └── OpenTracing.Tests/
├── appveyor.yml
├── editorconfig
├── gitattributes
├── gitignore
├── travis.yml
├── Directory.Build.props
├── LICENSE
├── NuGet.config
├── OpenTracing.sln
├── OpenTracing.snk
├── README.md
├── build.ps1
├── build.sh
└── version.props

目录介绍

• examples/: 包含示例代码，展示如何使用 OpenTracing API。
• src/OpenTracing/: 包含 OpenTracing API 的核心实现。
• test/OpenTracing.Tests/: 包含单元测试和集成测试。
• appveyor.yml: AppVeyor 持续集成配置文件。
• editorconfig: 编辑器配置文件，用于统一代码风格。
• gitattributes: Git 属性配置文件。
• gitignore: Git 忽略文件配置。
• travis.yml: Travis CI 持续集成配置文件。
• Directory.Build.props: MSBuild 属性配置文件。
• LICENSE: 项目许可证文件。
• NuGet.config: NuGet 配置文件。
• OpenTracing.sln: Visual Studio 解决方案文件。
• OpenTracing.snk: 密钥文件，用于代码签名。
• README.md: 项目说明文档。
• build.ps1: PowerShell 构建脚本。
• build.sh: Shell 构建脚本。
• version.props: 版本属性配置文件。

2. 项目的启动文件介绍

项目的启动文件通常位于 examples/ 目录下，用于展示如何启动和使用 OpenTracing API。以下是一个示例启动文件的介绍：

using System;
using Microsoft.Extensions.Logging;
using OpenTracing.Util;

namespace OpenTracingTutorial.Lesson01
{
    internal class Hello
    {
        private readonly ITracer _tracer;
        private readonly ILogger<Hello> _logger;

        public Hello(ILoggerFactory loggerFactory)
        {
            _tracer = GlobalTracer.Instance;
            _logger = loggerFactory.CreateLogger<Hello>();
        }

        public void SayHello(string helloTo)
        {
            using (IScope scope = _tracer.BuildSpan("say-hello").StartActive(true))
            {
                scope.Span.SetTag("hello-to", helloTo);
                string helloString = $"Hello, {helloTo}!";
                scope.Span.Log(new Dictionary<string, object>
                {
                    [LogFields.Event] = "string.format",
                    ["value"] = helloString
                });
                _logger.LogInformation(helloString);
            }
        }
    }

    public class Program
    {
        public static void Main(string[] args)
        {
            using (var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole()))
            {
                var hello = new Hello(loggerFactory);
                hello.SayHello("Bryan");
            }
        }
    }
}

启动文件介绍

• Hello 类: 包含 SayHello 方法，用于创建和记录一个 span。
• Program 类: 包含 Main 方法，用于启动应用程序并调用 Hello 类的 SayHello 方法。

3. 项目的配置文件介绍

项目的配置文件主要包括以下几个：

appveyor.yml

AppVeyor 持续集成配置文件，用于自动化构建和测试。

# appveyor.yml 内容示例
version: '{build}'
image: Visual Studio 2019
build_script:
- ps: .\build.ps1
test: off

editorconfig

编辑器配置文件，用于统一代码风格。

# editorconfig 内容示例
root = true

[*]
indent_style = space
indent_size = 4
tab_width = 4
end_of_line = lf
charset = utf-8
trim_tra

opentracing-csharpOpenTracing API for C# (.NET). 🛑 This library is DEPRECATED! https://github.com/opentracing/specification/issues/163项目地址:https://gitcode.com/gh_mirrors/op/opentracing-csharp