[HOLD for payment 2024-06-13] MEDIUM: [$250] Add logging around offline state to help diagnose bugs

[m-natarajan]

If you haven’t already, check out our contributing guidelines for onboarding and email [email protected] to request to join our Slack channel!

---

Version Number: Needs reproduction
Reproducible in staging?: N/A
Reproducible in production?: N/A
If this was caught during regression testing, add the test name, ID and link from TestRail:
Email or phone of affected tester (no customers): @quinthar
Logs: https://stackoverflow.com/c/expensify/questions/4856
Expensify/Expensify Issue URL:
Issue reported by: @quinthar
Slack conversation: https://expensify.slack.com/archives/C049HHMV9SM/p1712886605520589

Action Performed:

1. Open NewDot being online
2. Observe there is a message " You appear to be offline"
3. Do some actions and check the API request

Expected Result:

• " You appear to be offline" should not show when online
• If offline then success 200 OK API request should not be showin
• No pusher notification
  Add something to the logs that will help diagnose this

Actual Result:

• " You appear to be offline" message appears when online
• Success 200 OK API request appears
• Push notification is received
  I don't see anything useful in the logs. Can we maybe improve the logging around whatever code we use to determine if we're online to output its logic so we can diagnose and fix it.

Workaround:

unknown

Platforms:

Which of our officially supported platforms is this issue occurring on?

• Android: Native
• Android: mWeb Chrome
• iOS: Native
• iOS: mWeb Safari
• MacOS: Chrome / Safari
• MacOS: Desktop

Screenshots/Videos

Add any screenshot/video evidence

View all open jobs on GitHub

Upwork Automation - Do Not Edit

• Upwork Job URL: https://www.upwork.com/jobs/~016051a56c40abfc4a
• Upwork Job ID: 1782729213837856768
• Last Price Increase: 2024-04-23
• Automatic offers:
• nkdengineer | Contributor | 0

Issue Owner

Current Issue Owner: @sonialiap

[melvin-bot]

Triggered auto assignment to @sonialiap (Bug), see https://stackoverflow.com/c/expensify/questions/14418 for more details. Please add this bug to a GH project, as outlined in the SO.

[MelvinBot]

This has been labelled "Needs Reproduction". Follow the steps here: https://stackoverflowteams.com/c/expensify/questions/16989

[melvin-bot]

@sonialiap Whoops! This issue is 2 days overdue. Let's get this updated quick!

[sonialiap]

I can reproduce, but not consistently. Sometimes when I open ND the "you're offline" message appears and then usually clears within 30 seconds. If I open ND, close, and immediately open a new tab with ND the message doesn't appear. It seems to require some time between opening ND in a new tab for it to show as offline

[melvin-bot]

Job added to Upwork: https://www.upwork.com/jobs/~016051a56c40abfc4a

[melvin-bot]

Triggered auto assignment to Contributor-plus team member for initial proposal review - @Santhosh-Sellavel (External)

[nkdengineer]

Proposal

Please re-state the problem that we are trying to solve in this issue.

Nothing useful in the logs to debug online/offline issues

What is the root cause of that problem?

We don't have such logs.

What changes do you think we should make in order to solve the problem?

There're 3 places we're setting offline status via setOfflineStatus, we should add additional logs with the context by Log.info

1. In

   App/src/libs/NetworkConnection.ts

   Line 62 in 7ca0748

   setOfflineStatus(true);

   
   We should log:

Log.info(`[NetworkStatus] Setting "offlineStatus" to "true" because user is under force offline`);

2. In

   App/src/libs/NetworkConnection.ts

   Line 65 in 7ca0748

   NetInfo.fetch().then((state) => setOfflineStatus((state.isInternetReachable ?? false) === false));

We should log the full state that NetInfo returned

Log.info(`[NetworkStatus] The user is not under force offline, calling NetInfo.fetch, setting "offlineStatus" to ${(state.isInternetReachable ?? false) === false} with network state: ${JSON.stringify(state)}`);

3. In

   App/src/libs/NetworkConnection.ts

   Line 109 in 7ca0748

   setOfflineStatus((state.isInternetReachable ?? false) === false);

We should log the full state that NetInfo returned, and mention that this is set in NetInfo.addEventListener

Log.info(`[NetworkStatus] NetInfo.addEventListener event coming, setting "offlineStatus" to ${(state.isInternetReachable ?? false) === false} with network state: ${JSON.stringify(state)}`);

We can logs the logic we use to determine offline status (state.isInternetReachable ?? false) === false, if that's necessary.

Those are the core places we need the logs, the specifics of the log content/params can be adjusted in the PR phase.

What alternative solutions did you explore? (Optional)

Currently we have only true/false network status, if later we decide to have enum/number/string network statuses, then we need to log that value in the same way.

[melvin-bot]

@sonialiap, @Santhosh-Sellavel Whoops! This issue is 2 days overdue. Let's get this updated quick!

[quinthar]

What's the next step here, and the ETA?

[melvin-bot]

@sonialiap @Santhosh-Sellavel this issue was created 2 weeks ago. Are we close to approving a proposal? If not, what's blocking us from getting this issue assigned? Don't hesitate to create a thread in #expensify-open-source to align faster in real time. Thanks!

[Santhosh-Sellavel]

@nkdengineer's proposal LGTM!

C+ Reviewed
🎀 👀 🎀

[melvin-bot]

This issue has not been updated in over 15 days. @sonialiap, @Santhosh-Sellavel, @hayata-suenaga, @nkdengineer eroding to Monthly issue.

P.S. Is everyone reading this sure this is really a near-term priority? Be brave: if you disagree, go ahead and close it out. If someone disagrees, they'll reopen it, and if they don't: one less thing to do!

[hayata-suenaga]

The PR has been merged

[melvin-bot]

The solution for this issue has been 🚀 deployed to production 🚀 in version 1.4.79-11 and is now subject to a 7-day regression period 📆. Here is the list of pull requests that resolve this issue:

• Add offline status log #41719

If no regressions arise, payment will be issued on 2024-06-13. 🎊

For reference, here are some details about the assignees on this issue:

• @Santhosh-Sellavel requires payment through NewDot Manual Requests
• @nkdengineer requires payment automatic offer (Contributor)

[melvin-bot]

BugZero Checklist: The PR fixing this issue has been merged! The following checklist (instructions) will need to be completed before the issue can be closed:

• [@hayata-suenaga] The PR that introduced the bug has been identified. Link to the PR:
• [@hayata-suenaga] The offending PR has been commented on, pointing out the bug it caused and why, so the author and reviewers can learn from the mistake. Link to comment:
• [@hayata-suenaga] A discussion in #expensify-bugs has been started about whether any other steps should be taken (e.g. updating the PR review checklist) in order to catch this type of bug sooner. Link to discussion:
• [@Santhosh-Sellavel / @nkdengineer] Determine if we should create a regression test for this bug.
• [@Santhosh-Sellavel / @nkdengineer] If we decide to create a regression test for the bug, please propose the regression test steps to ensure the same bug will not reach production again.
• [@sonialiap] Link the GH issue for creating/updating the regression test once above steps have been agreed upon:

[hayata-suenaga]

[@hayata-suenaga] The PR that introduced the bug has been identified. Link to the PR:

This issue not a bug fix. It's about adding a logging

[@hayata-suenaga] The offending PR has been commented on, pointing out the bug it caused and why, so the author and reviewers can learn from the mistake. Link to comment:

N/A

[@hayata-suenaga] A discussion in #expensify-bugs has been started about whether any other steps should be taken (e.g. updating the PR review checklist) in order to catch this type of bug sooner. Link to discussion:

N/A

[sonialiap]

Payment summary
@Santhosh-Sellavel $250 - please request in ND
@nkdengineer $250 - offer sent

Please complete the two steps on the checklist

[sonialiap]

@nkdengineer please accept the offer so that I can issue payment

[nkdengineer]

@sonialiap Could you help to add the High Priority label to the issue, similar to this case? This was HIGH priority when the issue was opened, and only changed after the PR is up.

[hayata-suenaga]

@sonialiap, just as a note, the PR causes a regression although I'm not familiar with the policy on how regressions affect the bounty amount 🤔

[sonialiap]

Thanks for the flag, @hayata-suenaga. In the case of regression the fee is reduced by 50% (source)

I think @nkdengineer 's request is reasonable because this issue was labeled as High April 16, the proposal was posted on April 23 and PR submitted after that. The issue was changed to Medium on May 12. Since the work was done while the issue was labeled as High, I think it's reasonable to update the price to $500.

With the regression the price falls to $250

Payment summary remains the same

• @Santhosh-Sellavel $250 - please request in ND
• @nkdengineer $250 - offer - paid ✔️

[nkdengineer]

@sonialiap Thank you, I accepted the sent offer 🙇

[sonialiap]

Since this is update is for improving logging, I don't think we need a regression test. Closing