Package io.opentelemetry.exporter.otlp.logs

Class OtlpGrpcLogRecordExporterBuilder

  • public final class OtlpGrpcLogRecordExporterBuilder
extends java.lang.Object
    Builder for OtlpGrpcLogRecordExporter.
    Since:
    1.27.0

    • Constructor Detail

      • OtlpGrpcLogRecordExporterBuilder

        OtlpGrpcLogRecordExporterBuilder()

    • Method Detail

      • setChannel

        @Deprecated
public OtlpGrpcLogRecordExporterBuilder setChannel​(io.grpc.ManagedChannel channel)
        Deprecated.
        Use setEndpoint(String). If you have a use case not satisfied by the methods on this builder, please file an issue to let us know what it is.
        Sets the managed chanel to use when communicating with the backend. Takes precedence over setEndpoint(String) if both are called.

        Note: calling this overrides the spec compliant User-Agent header. To ensure spec compliance, set ManagedChannelBuilder.userAgent(String) to OtlpUserAgent.getUserAgent() when building the channel.

        Parameters:
        channel - the channel to use
        Returns:
        this builder's instance

      • setTimeout

        public OtlpGrpcLogRecordExporterBuilder setTimeout​(long timeout,
                                                   java.util.concurrent.TimeUnit unit)
        Sets the maximum time to wait for the collector to process an exported batch of logs. If unset, defaults to 10Ls.

      • setTimeout

        public OtlpGrpcLogRecordExporterBuilder setTimeout​(java.time.Duration timeout)
        Sets the maximum time to wait for the collector to process an exported batch of logs. If unset, defaults to 10Ls.

      • setConnectTimeout

        public OtlpGrpcLogRecordExporterBuilder setConnectTimeout​(long timeout,
                                                          java.util.concurrent.TimeUnit unit)
        Sets the maximum time to wait for new connections to be established. If unset, defaults to 10Ls.
        Since:
        1.36.0

      • setConnectTimeout

        public OtlpGrpcLogRecordExporterBuilder setConnectTimeout​(java.time.Duration timeout)
        Sets the maximum time to wait for new connections to be established. If unset, defaults to 10Ls.
        Since:
        1.36.0

      • setCompression

        public OtlpGrpcLogRecordExporterBuilder setCompression​(java.lang.String compressionMethod)
        Sets the method used to compress payloads. If unset, compression is disabled. Compression method "gzip" and "none" are supported out of the box. Support for additional compression methods is available by implementing Compressor and CompressorProvider.

      • setTrustedCertificates

        public OtlpGrpcLogRecordExporterBuilder setTrustedCertificates​(byte[] trustedCertificatesPem)
        Sets the certificate chain to use for verifying servers when TLS is enabled. The byte[] should contain an X.509 certificate collection in PEM format. If not set, TLS connections will use the system default trusted certificates.

      • setClientTls

        public OtlpGrpcLogRecordExporterBuilder setClientTls​(byte[] privateKeyPem,
                                                     byte[] certificatePem)
        Sets ths client key and the certificate chain to use for verifying client when TLS is enabled. The key must be PKCS8, and both must be in PEM format.

      • setSslContext

        public OtlpGrpcLogRecordExporterBuilder setSslContext​(javax.net.ssl.SSLContext sslContext,
                                                      javax.net.ssl.X509TrustManager trustManager)
        Sets the "bring-your-own" SSLContext for use with TLS. Users should call this _or_ set raw certificate bytes, but not both.

      • addHeader

        public OtlpGrpcLogRecordExporterBuilder addHeader​(java.lang.String key,
                                                  java.lang.String value)
        Add a constant header to requests. If the key collides with another constant header name or a one from setHeaders(Supplier), the values from both are included. Applicable only if setChannel(ManagedChannel) is not used to set channel.
        Parameters:
        key - header key
        value - header value
        Returns:
        this builder's instance

      • setHeaders

        public OtlpGrpcLogRecordExporterBuilder setHeaders​(java.util.function.Supplier<java.util.Map<java.lang.String,​java.lang.String>> headerSupplier)
        Set the supplier of headers to add to requests. If a key from the map collides with a constant from addHeader(String, String), the values from both are included. Applicable only if setChannel(ManagedChannel) is not used to set channel.
        Since:
        1.33.0

      • build

        public OtlpGrpcLogRecordExporter build()
        Constructs a new instance of the exporter based on the builder's values.
        Returns:
        a new exporter's instance