Skip to content

Clean up and clarify Crashlytics logging. #2362

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

Merged
merged 6 commits into from
Jan 27, 2021

Conversation

mrwillis21
Copy link
Contributor

@mrwillis21 mrwillis21 commented Jan 26, 2021

Made some log messages clearer and easier to understand, also
reduced noise by changing the log level on existing logs to:

E: Unexpected/error state, not recoverable. Crashlytics will not function.

W: Unexpected/error state, but recoverable.

D: SDK lifecycle logs ("what" is happening).

  • Unix-style "no news is good news" logging, if something goes
    wrong, it will appear in W or E logs.

V: Finer-grained logging ("how" things are happening).

  • "Success" logs, as well as logging of internally-stored values
    (e.g. current mapping file ID) are logged at this level.

Also modified a few logs to only print in an error case.

Made some log messages clearer and easier to understand, also
reduced noise by changing the log level on existing logs to:

E: Unexpected/error state, not recoverable. Crashlytics will not function.
W: Unexpected/error state, but recoverable.
D: SDK lifecycle logs ("what" is happening).
   - Unix-style "no news is good news" logging, if something goes
     wrong, it will appear in W or E logs.
V: Finer-grained logging ("how" things are happening).
   - "Success" logs, as well as logging of internally-stored values
     (e.g. current mapping file ID) are logged at this level.

Also modified a few logs to *only* print in an error case.
@mrwillis21 mrwillis21 requested a review from mrichards January 26, 2021 20:36
@google-cla google-cla bot added the cla: yes Override cla label Jan 26, 2021
@google-oss-bot
Copy link
Contributor

google-oss-bot commented Jan 26, 2021

Coverage Report

Affected SDKs

No changes between base commit (d03a08e) and head commit (c21b0f72).

Test Logs

Notes

HTML coverage reports can be produced locally with ./gradlew <product>:checkCoverage.
Report files are located at <product-build-dir>/reports/jacoco/.

Head commit (c21b0f72) is created by Prow via merging commits: d03a08e 893065e.

@google-oss-bot
Copy link
Contributor

google-oss-bot commented Jan 26, 2021

Binary Size Report

Affected SDKs

  • firebase-crashlytics

    Type Base (d03a08e) Head (c21b0f72) Diff
    aar 321 kB 322 kB +464 B (+0.1%)
    apk (aggressive) 192 kB 192 kB +272 B (+0.1%)
    apk (release) 817 kB 817 kB +248 B (+0.0%)
  • firebase-crashlytics-ndk

    Type Base (d03a08e) Head (c21b0f72) Diff
    aar 1.72 MB 1.72 MB -45 B (-0.0%)

Test Logs

Notes

Head commit (c21b0f72) is created by Prow via merging commits: d03a08e 893065e.

Copy link
Contributor

@mrichards mrichards left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have several comments where I think keeping the output as DEBUG will help with customer troubleshooting. Admittedly, these are based more on my subjective experiences with debugging customer issues than an application of a consistent standard for picking logging levels.

I feel most strongly about the mapping file ID one. I'm approving in advance assuming you'll at least change that one. If you have a major difference of opinion for the other ones, I won't put up an argument.

@mrwillis21 mrwillis21 merged commit 6dcf8f7 into master Jan 27, 2021
@mrwillis21 mrwillis21 deleted the cleanup-crashlytics-logging branch January 27, 2021 19:26
@firebase firebase locked and limited conversation to collaborators Feb 27, 2021
@mrwillis21 mrwillis21 restored the cleanup-crashlytics-logging branch March 5, 2021 21:12
@kaibolay kaibolay deleted the cleanup-crashlytics-logging branch September 15, 2022 13:32
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
cla: yes Override cla size/L
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants