swift-influxdb-telemetry

该库提供基于 Swift 的工具，用于将 InfluxDB 集成到您的应用程序中，以实现指标、日志记录、分析和追踪目的。

特性

指标收集：高效地收集和批量处理指标数据，以便写入 InfluxDB。
日志记录：可配置的日志记录，直接写入 InfluxDB，使用元数据标签以提高查询性能。
分析：将分析数据发送到 InfluxDB 进行分析和可视化。
追踪：支持分布式追踪，用于监控和故障排除。
批量处理和节流：支持批量处理和节流，以优化数据写入 InfluxDB。
可自定义标签：允许灵活的标签，以支持各种查询需求。

用法

设置指标工厂

import InfluxDBMetrics

MetricsSystem.bootstrap(
    InfluxDBMetricsFactory(
        url: "https://:8086",
        token: "your-token",
        org: "your-org-name",
        bucket: "your-bucket-name",
        precision: .ms, // Optional
        batchSize: 5000, // Optional
        throttleInterval: 5, // Optional
        dimensionsLabelsAsTags: .all // Optional
    )
)

设置日志处理程序

import InfluxDBLogs

LoggingSystem.bootstrap { name in
    InfluxDBLogHandler(
        name: name,
        url: "https://:8086",
        token: "your-token",
        org: "your-org-name",
        bucket: "your-bucket-name",
        precision: .ms, // Optional
        batchSize: 5000, // Optional
        throttleInterval: 5, // Optional
        metadataLabelsAsTags: .loggingDefault.union([.InfluxDBLogLabels.file]), // Optional
        logLevel: .info, // Optional
    )
}

设置分析

import InfluxDBAnalytics

AnalyticsSystem.bootstrap(
    InfluxDBAnalyticsHandler(
        url: "https://:8086",
        token: "your-token",
        org: "your-org-name",
        bucket: "your-bucket-name",
        precision: .ms, // Optional
        batchSize: 5000, // Optional
        throttleInterval: 5, // Optional
        parametersLabelsAsTags: .analyticsDefault.union([.InfluxDBAnalyticsLabels.file]), // Optional
    )
)

设置追踪

import InfluxDBTracing

InstrumentationSystem.bootstrap(
    InfluxDBTracer(
        url: "https://:8086",
        token: "your-token",
        org: "your-org-name",
        bucket: "your-bucket-name",
        precision: .ms, // Optional
        batchSize: 5000, // Optional
        throttleInterval: 5, // Optional
    )
)

写入指标、日志、分析和追踪数据

// Metrics
Counter(label: "page_views", dimensions: ["type": "homepage"]).increment()

// Analytics
Analytics().send("page_view", parameters: ["type": "homepage"])

// Logs
Logger(label: "app").error("Something went wrong!")

// Traces
withSpan("operation") { span in
    // Perform operation
}

安装

Swift 包管理器

创建一个 Package.swift 文件。

// swift-tools-version:5.9
import PackageDescription

let package = Package(
  name: "SomeProject",
  dependencies: [
    .package(url: "https://github.com/dankinsoid/swift-influxdb-telemetry.git", from: "1.10.0")
  ],
  targets: [
    .target(
        name: "SomeProject",
        dependencies: [
            .product(name: "InfluxDBLogs", package: "swift-influxdb-telemetry"),
            .product(name: "InfluxDBAnalytics", package: "swift-influxdb-telemetry"),
            .product(name: "InfluxDBMetrics", package: "swift-influxdb-telemetry"),
            .product(name: "InfluxDBTracing", package: "swift-influxdb-telemetry")
       ]
    )
  ]
)

$ swift build

作者

dankinsoid, voidilov@gmail.com

许可证

swift-influxdb-telemetry 根据 MIT 许可证提供。有关更多信息，请参见 LICENSE 文件。