Time Zone
It is important that the device has the correct time zone. This can be set before shipping or after installation, but it's important to make sure that the time zone is correct before you start collecting data.
To set the time zone, log into the console using a screen and keyboard, or simply open the REMOTE SHELL if the agent is already installed. If you are using the console, run sudo -i to get a root prompt.
In the shell, run the command:
This will show the current date, time and time zone. If the time zone is correct, there is nothing else to do in this section. If the time zone is incorrect, please go to the next step.
To see a list of available time zones, run the following command
For users on the console, use the space bar to scroll down the list. Make note of the desired time zone for the device and Ctrl-C to exit. For REMOTE SHELL users, you will be able to see the entire list in your browser, simply copy the desired time zone to paste into the next command.
In the shell run the command
This will change the time zone on the device. For example:
To confirm that the timezone has been set:
And the final step is to synchronise the timezone with the cloud. Browse to DEVICES -> <target device> -> Manual Config -> General. The time zone listed here will still be the old time zone. Trigger a refresh by clicking the three dots next to the device name and selecting "Refresh metadata". Within about 10s, you should get a message that the device config has been updated and the time zone listed in the General tab should now reflect the new time zone on the device.
Do not skip this final step! If you do not refresh the metadata, the cloud will not know about the time zone change and the data will be logged with a skewed event_time. If the time zone in the cloud does not match the timezone on the machine, then run "Refresh metadata" to force the device to re-synchronise.
Last updated