logging: document how to view logs
Fixes
@@ -38,7 +38,7 @@ Use a Client to interact with the Stackdriver Logging API.
Basic Usage
-For most use-cases, you'll want to add log entries to a buffer to be periodically
+For most use cases, you'll want to add log entries to a buffer to be periodically
flushed (automatically and asynchronously) to the Stackdriver Logging service.
// Initialize a logger
@@ -63,7 +63,7 @@ Synchronous Logging
For critical errors, you may want to send your log entries immediately.
LogSync is slow and will block until the log entry has been sent, so it is
-not recommended for basic use.
+not recommended for normal use.
lg.LogSync(ctx, logging.Entry{Payload: "ALERT! Something critical happened!"})
@@ -86,5 +86,15 @@ An Entry may have one of a number of severity levels associated with it.
Severity: logging.Critical,
}
+
+Viewing Logs
+
+You can view Stackdriver logs for projects at
+https://console.cloud.google.com/logs/viewer. From the dropdown at the top left,
+select "Google Project" and then the project ID. Logs for organizations, folders and
+billing accounts can be viewed on the command line with the "gcloud logging read"
+command.
+
+
*/
package logging // import "cloud.google.com/go/logging"
