If the PV Watts API goes down, all jobs in organizations using PV Watts Solar Production Methodology will be blocked.
How can I tell if PV Watts is down?
Check the Logs in Datadog, if the response is anything but a 200 response, then it is either responding in error or timing out.
Locate the sentry error
Check the organization writing in
Do they have PV Watts switched on in the Feature settings?
Confirm with Engineering:
Create a BT and include the Sentry, the org impacted, and the job
Engineering will confirm if there is an issue with the PV Watts API. If so, please follow the steps below…
What is the workaround when PV Watts is down?
Good news, the workaround for when PV Watts is down is simple, we disable PV Watts on the customer’s account while logged in as Sighten Admin under the feature settings. Here’s more on how to do this.
What do I do when a customer writes in during a PV Watts Outage?
If a customer writes in during a PV Watts outage, they’re likely blocked on the project phase.
Check to see if the org has PV Watts turned on.
If they have PV Watts on, you can send them the following chat or email:
Chat (this can be accessed in chat using the PV Watts out shortcut): The PVWatts API is currently down, causing your issues. As a workaround, we can switch your account to use the Sighten production methodology until PVWatts service is fixed. Please note this will impact all users in your account.
Email: Hi [Name],
The PVWatts API is currently down, causing your issues saving projects. As a workaround, we can switch your account to use the Sighten custom production methodology until PVWatts service is fixed. Please note this will impact all users in your account.
I am so sorry about the inconvenience. Please let us know if we can make this switch for you and otherwise we will let you know as soon as the issue is fixed.
Regards,
[your name]NOTE: Please always ask permission to turn off PV Watts for a customer. Do not do it for them unless they give you express consent to do so.
If they want more information about Sighten’s production methodology you can send them: How is solar production calculated in Sighten?
If the customer says you should switch them, first make the switch and then let the customer know they should be unblocked.
Email:Hi [Name],
This is to confirm that we have temporarily switched your organization off of PVWatts API. We will follow up here to let you know when it is back up and running.
If you’re still having issues, please try creating a new project on a job. Existing projects will attempt to use the production methodology that was active when it was created. We apologize for the inconvenience this outage may have caused.
Regards,
[your name]
Then, log what you did in this spreadsheet: https://docs.google.com/spreadsheets/d/1_BKiz9XWi8i1Oi5n8Uaf3ogaatVL0l2QaSZD5JD7xbs/edit#gid=545030185
Next link the SS ticket to the BT ticket
if it was a chat, please send the transcript to Jira, create the SS ticket and then link it to the BT ticket.
What if the customer is saying they’re still blocked?
It might be an issue with invalidation, this should be your first guess if they say the phases are spinning How do I make the quote and usage phases stop spinning?
Or if they are trying to recalculate on an existing project, then it is going to keep trying with the same calc method. So please instruct them that the best way to get unstuck is to start a new project from scratch.
Follow up with the customer and let them know that we will notify them when they have been switched back. You can use the following email template:
Hi [Name],
PV Watts has been temporarily disabled for your organization. We will let you know when it is back up and running and you are switched back. Please let us know if you’re still experiencing issues. We truly apologize for the inconvenience.
Best,
[Your Name]
When PV Watts is working again:
Switch customers back to PV Watts
Follow up with customers that were switched off with the following email:
Hi [Name],
Good morning. I wanted to let you know that the PV Watts issue has been resolved, and we have switched your organization back to using this methodology. Please let us know if you have any questions or need any additional assistance. We apologize for the inconvenience this may have caused.Have a great day!
Best,
[Your Name]
For customers that were impacted but did not switch, follow up with the following email:
Hi [Name],
Good morning. I wanted to let you know that the PV Watts API is back up and running. Please let us know if you have any questions or need any additional assistance. We apologize for the inconvenience this may have caused.Have a great day!
Best,
[Your Name]
Mark that you have followed up in this spreadsheet: https://docs.google.com/spreadsheets/d/1_BKiz9XWi8i1Oi5n8Uaf3ogaatVL0l2QaSZD5JD7xbs/edit#gid=0