naresh/eslogger

ElasticSearch logging library for laravel 5.6

1.0.2 2018-03-14 05:18 UTC

This package is auto-updated.

Last update: 2024-09-14 22:14:13 UTC


README

注意:您可以使用 Molong Elasticsearch Handler 来实现与该库相同的行为。但是它仅支持 Elastica 客户端。

如果您想使用 Elasticsearch logging channel 进行日志记录(Laravel >=5.6),则此库适合您。

安装

在 composer.json 文件中要求包。

    "require":{
        "naresh/eslogger": "1.0.*"
    }

然后运行 composer update 以更新依赖项。

配置

  • 在您的 config/logging.php 中添加 Elasticsearch logger

    'channels' => [
      'custom' => [
          'driver' => 'custom',
          'via' => \Naresh\ElasticSearchLogger\EsLog::class,
      ],
    ],
    
  • 添加 Elasticsearch 配置

    • 选项 1 使用 ENV 变量进行配置

      • ES_HOST

        • Elasticsearch 主机
      • IS_AWS_ES_HOST

        • 布尔标志,用于指定主机名是否为 AWS Elasticsearch 服务。但是,如果您的主机 URL 中包含 amazonaws,则无需添加此标志,此库将假定它为 AWS Elasticsearch 服务
      • AWS_ACCESS_KEY_ID(如果主机是 AWS Elasticsearch 服务,则需要)

        • AWS Elasticsearch 服务 访问密钥
      • AWS_SECRET_ACCESS_KEY(如果主机是 AWS Elasticsearch 服务,则需要)

        • AWS Elasticsearch 服务 密钥
      • AWS_REGION(如果主机是 AWS Elasticsearch 服务,则需要)

        • AWS Elasticsearch 服务 区域
      • ES_LOG_INDEX

        • 您想要发送日志的 Elasticsearch Index
      • ES_LOG_INDEX_TYPE

        • Elasticsearch Index 类型
    • 选项 2 如果您不想使用 ENV 变量,则可以在设置 config/logging.php 文件时进行配置。

      • 通过创建新实例
        • 创建一个 \Naresh\ElasticSearchLogger\EsLog 的新实例,如下所示
          • $eslogger = new \Naresh\ElasticSearchLogger\EsLog();
        • 然后通过传递选项到 EsLog 实例,将配置传递过去
          • 'channels' => [
                'custom' => [
                    'driver' => 'custom',
                    'via' => $esLogger(['options' => ['ES_HOST' => 'test.es.com']]),
                ],
            ],
            
      • 通过在日志配置中传递选项
        •   'channels' => [
                'custom' => [
                    'driver' => 'custom',
                    'via' => \Naresh\ElasticSearchLogger\EsLog::class,
                    'options' => [
                         "hosts" => ["test.es-server.com"],
                         "aws_host" => "",
                         "access_key" => "LK9823kjhsd",
                         "secret_key" => "LK9823kjhsd",
                         "region" => "ap-southeast-2",
                         "index" => "testIndex",
                         "index_type" => "testIndexType"]
                    ],
            ],