Example remote ElasticsearchLogstashHandler

pedroresende · wouterj · commit 9d762e72ff18 · 2022-10-09T17:01:42.000+02:00
diff --git a/logging/handlers.rst b/logging/handlers.rst
@@ -30,6 +30,15 @@ To use it, declare it as a service:
         services:
             Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler: ~
 
+            # optionally, configure the handler using the constructor arguments (shown values are default)
+            Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler: ~
+                arguments:
+                    $endpoint: "http://127.0.0.1:9200"
+                    $index: "monolog"
+                    $client: null
+                    $level: !php/const Monolog\Logger::DEBUG
+                    $bubble: true
+
     .. code-block:: xml
 
         <!-- config/services.xml -->
@@ -44,16 +53,37 @@ To use it, declare it as a service:
 
             <services>
                 <service id="Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler"/>
+
+                <!-- optionally, configure the handler using the constructor arguments (shown values are default) -->
+                <service id="Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler">
+                    <argument key="endpoint">http://127.0.0.1:9200</argument>
+                    <argument key="index">monolog</argument>
+                    <argument key="client"/>
+                    <argument key="level" type="constant">Monolog\Logger::DEBUG</argument>
+                    <argument key="bubble">true</argument>
+                </service>
             </services>
         </container>
 
     .. code-block:: php
 
         // config/services.php
+        use Monolog\Logger;
         use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
 
         $container->register(ElasticsearchLogstashHandler::class);
 
+        // optionally, configure the handler using the constructor arguments (shown values are default)
+        $container->register(ElasticsearchLogstashHandler::class)
+            ->setArguments(
+                '$endpoint' => "http://127.0.0.1:9200",
+                '$index' => "monolog",
+                '$client' => null,
+                '$level' => Logger::DEBUG,
+                '$bubble' => true,
+            )
+        ;
+
 Then reference it in the Monolog configuration:
 
 .. configuration-block::
