LogEntry (Google Cloud 0.119.0-alpha API)

java.lang.Object
- com.google.cloud.logging.LogEntry

All Implemented Interfaces:

Serializable
```
public class LogEntry
extends Object
implements Serializable
```
A Stackdriver Logging log entry. All log entries are represented via objects of this class. Log entries can have different type of payloads: an UTF-8 string (see Payload.StringPayload), a JSON object (see Payload.JsonPayload, or a protobuf object (see Payload.ProtoPayload). Entries can also store additional information about the operation or the HTTP request that generated the log (see getOperation() and getHttpRequest(), respectively).

See Also:

Log Entries and Logs, Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class LogEntry.Builder
A builder for LogEntry objects.

Nested Classes
Modifier and Type	Class and Description
`static class`	`LogEntry.Builder` A builder for `LogEntry` objects.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)`
`HttpRequest`	`getHttpRequest()` Returns information about the HTTP request associated with this log entry, if applicable.
`String`	`getInsertId()` Returns a unique ID for the log entry.
`Map<String,String>`	`getLabels()` Returns an optional set of user-defined (key, value) data that provides additional information about the log entry.
`String`	`getLogName()` Returns the name of the log to which this log entry belongs.
`Operation`	`getOperation()` Returns information about an operation associated with the log entry, if applicable.
`<T extends Payload> T`	`getPayload()` Returns the payload for this log entry.
`Long`	`getReceiveTimestamp()` Returns the time the log entry was received by Stackdriver Logging.
`com.google.cloud.MonitoredResource`	`getResource()` Returns the monitored resource associated with this log entry.
`Severity`	`getSeverity()` Returns the severity of the log entry.
`SourceLocation`	`getSourceLocation()` Returns the source code location information associated with the log entry, if any.
`String`	`getSpanId()` Returns the ID of the trace span associated with the log entry, if any.
`Long`	`getTimestamp()` Returns the time at which the event described by the log entry occurred, in milliseconds.
`String`	`getTrace()` Returns the resource name of the trace associated with the log entry, if any.
`boolean`	`getTraceSampled()` Returns the sampling decision of the trace span associated with the log entry, or `false` if there is no trace span.
`int`	`hashCode()`
`static LogEntry.Builder`	`newBuilder(Payload<?> payload)` Returns a builder for `LogEntry` objects given the entry payload.
`static LogEntry`	`of(Payload<?> payload)` Creates a `LogEntry` object given the entry payload.
`static LogEntry`	`of(String logName, com.google.cloud.MonitoredResource resource, Payload<?> payload)` Creates a `LogEntry` object given the log name, the monitored resource and the entry payload.
`LogEntry.Builder`	`toBuilder()` Returns a `Builder` for this log entry.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - getLogName
```
public String getLogName()
```
    Returns the name of the log to which this log entry belongs. The log name must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters: [A-Za-z0-9]; and punctuation characters: _-./. The forward-slash (/) characters in the log name must be URL-encoded. Examples: syslog, library.googleapis.com%2Fbook_log.
  - getResource
```
public com.google.cloud.MonitoredResource getResource()
```
    Returns the monitored resource associated with this log entry. Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error.
  - getTimestamp
```
public Long getTimestamp()
```
    Returns the time at which the event described by the log entry occurred, in milliseconds. If omitted, the Logging service will use the time at which the log entry is received.
  - getReceiveTimestamp
```
public Long getReceiveTimestamp()
```
    Returns the time the log entry was received by Stackdriver Logging.
  - getSeverity
```
public Severity getSeverity()
```
    Returns the severity of the log entry. If not set, Severity.DEFAULT is used.
  - getInsertId
```
public String getInsertId()
```
    Returns a unique ID for the log entry. The Logging service considers other log entries in the same log with the same ID as duplicates which can be removed.
  - getHttpRequest
```
public HttpRequest getHttpRequest()
```
    Returns information about the HTTP request associated with this log entry, if applicable.
  - getLabels
```
public Map<String,String> getLabels()
```
    Returns an optional set of user-defined (key, value) data that provides additional information about the log entry.
  - getOperation
```
public Operation getOperation()
```
    Returns information about an operation associated with the log entry, if applicable.
  - getTrace
```
public String getTrace()
```
    Returns the resource name of the trace associated with the log entry, if any. If it contains a relative resource name, the name is assumed to be relative to `//tracing.googleapis.com`.
  - getSpanId
```
public String getSpanId()
```
    Returns the ID of the trace span associated with the log entry, if any.
  - getTraceSampled
```
public boolean getTraceSampled()
```
    Returns the sampling decision of the trace span associated with the log entry, or false if there is no trace span.
  - getSourceLocation
```
public SourceLocation getSourceLocation()
```
    Returns the source code location information associated with the log entry, if any.
  - getPayload
```
public <T extends Payload> T getPayload()
```
    Returns the payload for this log entry. The log entry payload can be an UTF-8 string (see Payload.StringPayload), a JSON object (see Payload.JsonPayload, or a protobuf object (see Payload.ProtoPayload).
    
    See Also:
    
    Log Entries and Logs
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - toBuilder
```
public LogEntry.Builder toBuilder()
```
    Returns a Builder for this log entry.
  - newBuilder
```
public static LogEntry.Builder newBuilder(Payload<?> payload)
```
    Returns a builder for LogEntry objects given the entry payload.
  - of
```
public static LogEntry of(Payload<?> payload)
```
    Creates a LogEntry object given the entry payload.
  - of
```
public static LogEntry of(String logName,
                          com.google.cloud.MonitoredResource resource,
                          Payload<?> payload)
```
    Creates a LogEntry object given the log name, the monitored resource and the entry payload.

Class LogEntry

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getLogName

getResource

getTimestamp

getReceiveTimestamp

getSeverity

getInsertId

getHttpRequest

getLabels

getOperation

getTrace

getSpanId

getTraceSampled

getSourceLocation

getPayload

hashCode

equals

toString

toBuilder

newBuilder

of

of