-
Notifications
You must be signed in to change notification settings - Fork 2.1k
KV v2 logging improvements #45418
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
KV v2 logging improvements #45418
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR focuses on improving logging practices across the KV v2 codebase by replacing ad hoc try‐catch blocks and manual exception constructions with a consistent usage of key‐value logging and utility methods. The key changes include using LOGGER.throwableAtError().log(...) in place of LOGGER.logThrowableAsError() and adopting Objects.requireNonNull for null checks.
Reviewed Changes
Copilot reviewed 44 out of 44 changed files in this pull request and generated no comments.
File | Description |
---|---|
sdk/keyvault-v2/azure-security-keyvault-keys/.../Aes128Kw.java | Updated key validation to pass LOGGER for consistent error logging. |
sdk/keyvault-v2/azure-security-keyvault-keys/.../CryptographyClientBuilder.java | Replaced try-catch error wrapping with direct LOGGER.throwableAtError() calls. |
sdk/keyvault-v2/azure-security-keyvault-keys/.../KeyClientBuilder.java | Replaced manual null-checks with Objects.requireNonNull. |
(Numerous certificate and administration files) | Standardized logging exceptions and null checks, removed redundant try-catch blocks and improved error messages with key-value metadata. |
Comments suppressed due to low confidence (3)
sdk/keyvault-v2/azure-security-keyvault-keys/src/main/java/com/azure/v2/security/keyvault/keys/cryptography/CryptographyClientBuilder.java:151
- Verify that replacing the catch-log-rethrow pattern with direct logging using throwableAtError() produces the intended exception type and message consistency across the API.
throw LOGGER.throwableAtError().log("Key caching cannot be disabled when using a JSON Web Key.", IllegalStateException::new);
sdk/keyvault-v2/azure-security-keyvault-administration/src/main/java/com/azure/v2/security/keyvault/administration/KeyVaultAdministrationUtil.java:192
- [nitpick] Consider adding more contextual information (such as method or parameter names) to the log message to help diagnose unsupported operation types more easily.
throw logger.throwableAtError().addKeyValue("operationType", operation == null ? null : operation.getClass().getCanonicalName()).log(UnsupportedOperationException::new);
sdk/keyvault-v2/azure-security-keyvault-keys/src/main/java/com/azure/v2/security/keyvault/keys/cryptography/implementation/Aes128Kw.java:29
- Ensure that passing the LOGGER instance to the validation method is safe and that the method properly handles a null logger if it could occur in other contexts.
CryptographyUtils.validate(key, KEY_SIZE_IN_BYTES, LOGGER);
} catch (RuntimeException e) { | ||
throw LOGGER.logThrowableAsError(e); | ||
} | ||
Objects.requireNonNull(roleScope, "'roleScope' cannot be null."); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the String.format(CANNOT_BE_NULL, "'roleScope'")
happens on every operation and there is really no need to do it
Logging + exceptions improvements: