svix-cli: add tracing support (#2114)

This is helpful for debugging. Rather than use the `RUST_LOG` env var,
I've used the standard Unix `-v` / `--verbose` flags.

Author: svix-jbrown

svix-cli/Cargo.lock

@@ -52,6 +52,8 @@ serde_json = "1.0.133"
 svix = { path = "../rust" }
 tokio = { version = "1.42.0", features = ["macros", "time", "rt-multi-thread"] }
 tokio-tungstenite = { version = "0.26.0", features = ["rustls-tls-native-roots"] }
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features=["std", "ansi", "fmt", "registry", "local-time"], default-features = false }
 toml = "0.8.19"
 url = "2.5.4"
 

svix-cli/Cargo.toml

@@ -37,6 +37,13 @@ const BIN_NAME: &str = env!("CARGO_BIN_NAME");
 struct Cli {
     #[command(flatten)]
     color: Color,
+    #[arg(
+        short,
+        long,
+        action = clap::ArgAction::Count,
+        help = "Log more. This option may be repeated up to 3 times"
+    )]
+    verbose: u8,
     #[command(subcommand)]
     command: RootCommands,
 }
@@ -53,6 +60,15 @@ impl Cli {
             ColorChoice::Never => ColorMode::Off,
         }
     }
+
+    fn log_level(&self) -> tracing::Level {
+        match self.verbose {
+            3.. => tracing::Level::TRACE,
+            2 => tracing::Level::DEBUG,
+            1 => tracing::Level::INFO,
+            0 => tracing::Level::WARN,
+        }
+    }
 }
 
 // N.b Ordering matters here for how clap presents the help.
@@ -103,6 +119,11 @@ async fn main() -> Result<()> {
     let cli = Cli::parse();
     let color_mode = cli.color_mode();
 
+    tracing_subscriber::fmt()
+        .with_max_level(cli.log_level())
+        .with_timer(tracing_subscriber::fmt::time::LocalTime::rfc_3339())
+        .init();
+
     // rustls requires a crypto backend ("provider") choice to be made explicitly
     // The Svix SDK uses the default provider if a default is not installed, but
     // we use reqwest directly in some code paths, which does not do this.